Connect ConveyThis to Claude, Cursor & VS Code

Add the ConveyThis MCP server to any client that speaks Streamable HTTP with a bearer token. Create a key, paste a few lines of config, and your AI agent can read your translation data in under a minute.

1. Create your API key

Open your ConveyThis dashboard, go to MCP / AI Agents, and create a key. Your key looks like ct_mcp_… and is shown once — copy it before you close the dialog. Every key is read-only and revocable at any time.

2. Add the MCP server to your client

The ConveyThis MCP server is a Streamable HTTP endpoint. Point your client at:

https://mcp.conveythis.com/mcp

Authenticate by sending your key as a bearer token on every request: Authorization: Bearer ct_mcp_…. Use the per-client config below.

Claude Code

Add the server from your terminal:

claude mcp add --transport http conveythis https://mcp.conveythis.com/mcp \
  --header "Authorization: Bearer ct_mcp_YOUR_KEY"

Cursor

Add to ~/.cursor/mcp.json (or the project .cursor/mcp.json):

{
  "mcpServers": {
    "conveythis": {
      "url": "https://mcp.conveythis.com/mcp",
      "headers": { "Authorization": "Bearer ct_mcp_YOUR_KEY" }
    }
  }
}

VS Code (Copilot / MCP)

Add to your workspace .vscode/mcp.json:

{
  "servers": {
    "conveythis": {
      "type": "http",
      "url": "https://mcp.conveythis.com/mcp",
      "headers": { "Authorization": "Bearer ct_mcp_YOUR_KEY" }
    }
  }
}

MCP Inspector

Launch the Inspector and connect to a Streamable HTTP server:

npx @modelcontextprotocol/inspector

In the UI, set Transport to Streamable HTTP, the URL to https://mcp.conveythis.com/mcp, and add an Authorization header with value Bearer ct_mcp_YOUR_KEY.

Cline & Windsurf (generic Streamable HTTP)

Any client that supports a remote MCP server over Streamable HTTP with a bearer token works the same way — give it the URL https://mcp.conveythis.com/mcp and the header Authorization: Bearer ct_mcp_YOUR_KEY. In Cline, add a remote server in MCP settings; in Windsurf, add it under Cascade → MCP servers.

3. Ask your agent

Once connected, ask in plain language: “How far along is my Spanish translation?” or “What's our approved German term for ‘dashboard’?”

Scopes — what a key can read

Every key is granted all six read-only scopes. There is no write scope.

ScopeLets the agent read
mcp:projects:readYour translation projects and per-project details
mcp:stats:readTranslation progress and word statistics
mcp:translations:readTranslated strings (search across a project)
mcp:glossary:readGlossary terms and approved translations
mcp:rules:readActive translation rules
mcp:billing:readPlan usage and billing status (read-only)

Lost a key or suspect it leaked? Revoke it from the MCP / AI Agents page and create a new one — revocation takes effect immediately.

Ready to Get Started?

Translation, far more than just knowing languages, is a complex process.

By following our tips and using ConveyThis , your translated pages will resonate with your audience, feeling native to the target language.

While it demands effort, the result is rewarding. If you're translating a website, ConveyThis can save you hours with automated machine translation.

Try ConveyThis free for 3 days!