How to Use the ONES MCP in Claude Code

Q: How do I install the ONES MCP server for Claude Code?

Run claude mcp add --transport http ones-mcp -- in your terminal. Make sure you put the transport flags before the server name, then use claude mcp list to confirm the connection.

Q: How does Claude Code know which ONES project to update?

The agent queries listprojects to match your repository name with the corresponding internal board. If the names differ, you can explicitly pass the project UUID in your prompt.

Connect Claude Code to ONES and manage enterprise R&D tasks via this MCP integration directly from your terminal or CI/CD pipelines.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect ONES MCP to Claude Code

Create your Vinkius account to connect ONES to Claude Code — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup ONES with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Headless Task Management via MCP Server

DevOps engineers don't want to click through a web portal to log infrastructure changes. Claude Code lets you pipe a failed deployment log straight into `create_task` directly from your shell. The CLI agent automatically formats the payload, checks `list_task_types` to tag it as an incident, and assigns it to the on-call engineer. You handle complete project management without ever leaving your terminal window.

Automate Release Notes and Audits

Scraping together a changelog before a Friday deployment is a massive time sink. You can script Claude Code to run `list_tasks` against your current sprint and filter out everything that isn't merged. It pulls the exact descriptions using `get_task_details` and formats them into a clean markdown file. If you need to verify who approved what, the agent pulls `list_members` to cross-reference the reviewers against your organization chart.

Enforce Strict Workflow Transitions

CI/CD pipelines fail when developers forget to update their ticket statuses. You can integrate Claude Code into a GitHub Action that triggers `list_workflows` via the MCP server whenever a pull request merges. The headless agent verifies the target project via `get_project` to ensure it hits the right board. It then fires `update_task` to push the ticket into the deployment column automatically.

Setup guide

Set up ONES MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see ones-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest ONES transactions." It will automatically discover and invoke the available ONES tools.

Terminal

claude mcp add --transport http ones-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the ONES MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "ones-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ONES. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ONES now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ONES MCP in Claude Code

Run `claude mcp add --transport http ones-mcp -- ` in your terminal. Make sure you put the transport flags before the server name, then use `claude mcp list` to confirm the connection.

Yes, you can pipe standard output directly into the agent. It parses your script's output and executes `create_task` to log the results on your enterprise board.

The agent queries `list_projects` to match your repository name with the corresponding internal board. If the names differ, you can explicitly pass the project UUID in your prompt.

The user UUID probably doesn't match the display name in your git config. Have the agent run `list_members` to pull the exact internal IDs before it attempts the assignment.

The workflow transition rules and task metadata pulled by the terminal agent are protected by strict endpoint authentication. Vinkius manages the connection so your proprietary sprint backlogs only pass through an encrypted, ephemeral tunnel.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript