MCP Setup

CodeTeleport ships an MCP server (codeteleport-mcp) that lets your AI agent push, pull, and manage sessions without leaving the conversation. This page covers how to wire it up.

Claude Code

Quick (recommended)

Run one command in your terminal:

claude mcp add codeteleport -- codeteleport-mcp

Claude Code will register the server and make all six tools available in every conversation.

Manual

Open your Claude Code settings file (~/.claude/settings.json) and add the server entry:

{
  "mcpServers": {
    "codeteleport": {
      "command": "codeteleport-mcp",
      "args": []
    }
  }
}

Save the file and restart Claude Code.

Verify

Start a Claude Code conversation and ask:

show me my CodeTeleport status

You should see output like:

CodeTeleport Status
  user     : alice@example.com
  device   : Alices-Laptop.local
  api      : https://api.codeteleport.com
  plan     : free
  sessions : 3 / 25
  devices  : 2 / 3

If you get an authentication error, make sure you have logged in first.

Other Agents

Cursor

Caution

Cursor support is coming soon. CodeTeleport’s MCP server follows the standard protocol, so integration is straightforward once Cursor enables MCP tool calling.

Windsurf

Caution

Windsurf support is coming soon. We are tracking Windsurf’s MCP roadmap and will publish setup instructions as soon as it is available.

Other MCP-Compatible Agents

CodeTeleport follows the Model Context Protocol standard. If your agent supports MCP tool servers, point it at the codeteleport-mcp executable and it should work out of the box.

Running into issues? Open an issue on GitHub and let us know which agent you are using.

Next step

See the full list of MCP tools that CodeTeleport exposes.