How to Use the Cody AI MCP in Claude Code

Q: How do I install the Cody AI MCP Server in Claude Code?

Run claude mcp add --transport http cody-ai in your terminal. This saves the configuration to your /.claude.json file and connects Claude Code instantly.

Q: How does Claude Code fetch conversation transcripts from Cody AI?

Claude Code uses listmessages to fetch the raw message history of any conversation. You can pipe this output directly to standard Unix utilities like grep or jq.

Q: Does this server support listing all active bots?

Yes, the listbots tool returns all configured bots and their metadata. This allows you to quickly verify which bot IDs are available for your scripts.

Run headless Cody AI knowledge imports and bot tests directly from the Claude Code terminal via this MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cody AI MCP to Claude Code

Create your Vinkius account to connect Cody AI to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Cody AI with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pipe terminal outputs into this MCP Server

`import_webpage` sends remote documentation directly to your Cody AI folders via simple CLI commands. Your agent triggers the import, then checks `get_document_status` to ensure the data is indexed. You can script this process to run during CI/CD builds. When you deploy new web docs, Claude Code can automatically trigger a sync so your support bots stay updated.

Query your bots directly from the CLI

`send_message` posts queries directly to any active conversation thread in your account. Claude Code uses `create_conversation` to open a session, allowing headless testing from your terminal. This setup lets you build automated testing scripts. You can pipe a list of test questions to Claude Code, let it query your bots, and output the results to a local file.

Audit knowledge base structures in Claude Code

`list_folders` retrieves the complete directory layout of your Cody AI account. Claude Code combines this with `list_documents` to verify that your files are organized correctly. If documents are misplaced, your agent can identify the problem and report the exact paths. This helps maintain clean data boundaries across different support bots.

Setup guide

Set up Cody AI 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 cody-ai-mcp with a green status indicator.
3

Start using tools

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

Terminal

claude mcp add --transport http cody-ai-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 Cody AI 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": {
    "cody-ai-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 Cody AI. 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 Cody AI 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 Cody AI MCP in Claude Code

Run `claude mcp add --transport http cody-ai ` in your terminal. This saves the configuration to your `~/.claude.json` file and connects Claude Code instantly.

Yes, you can write shell scripts that command Claude Code to run `import_webpage`. It will execute the sync and monitor the status headlessly.

Claude Code uses `list_messages` to fetch the raw message history of any conversation. You can pipe this output directly to standard Unix utilities like grep or jq.

Yes, the `list_bots` tool returns all configured bots and their metadata. This allows you to quickly verify which bot IDs are available for your scripts.

Your conversation histories and message logs are securely routed through a single-use container. No transit details are logged or cached on Vinkius infrastructure, keeping your customer support records private.

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