MCP Setup

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

CodeTeleport supports three AI coding agents — Claude Code (id claude-code, default), Codex (OpenAI, id codex), and Antigravity (Google, id antigravity). The MCP server is the same for all three; only the registration command differs. Each agent registers the same seven tools.

Tip

The easiest path is codeteleport setup. Its Step 4 — MCP Integration offers to register the MCP server for whichever agent you selected, running the correct claude mcp add / codex mcp add / agy mcp add command for you. The manual commands below are for anyone who skips setup or wants to register the server by hand.

Register the MCP server

Pick your agent and run its mcp add command. Claude Code is shown first as the default, but Codex and Antigravity are fully supported equals — each registers the same seven tools.

Claude Code

Run one command in your terminal:

claude mcp add codeteleport -- codeteleport-mcp

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

Codex

Run one command in your terminal:

codex mcp add codeteleport -- codeteleport-mcp

Codex will register the server and make all seven tools available in every conversation.

Antigravity

Run one command in your terminal:

agy mcp add codeteleport -- codeteleport-mcp

Antigravity will register the server and make all seven tools available in every conversation.

Manual (Claude Code only)

The JSON edit below is Claude-Code-specific. Codex and Antigravity register via their own codex mcp add / agy mcp add commands above, not via this file.

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.

Note

Not sure which agent you have configured? Run codeteleport setup to choose interactively (it lists all supported agents from the registry), or set it directly with codeteleport config set agent <claude-code|codex|antigravity>. Setting an unrecognized id fails with Unknown agent: <id>. Supported: claude-code, codex, antigravity. The agent setting controls only what is bundled/scanned locally (push, local list); it does not affect pull, which uses the bundle’s recorded agent.

Verify

Start a conversation in your agent — Claude Code, Codex, or Antigravity — and ask:

show me my CodeTeleport status

This calls the teleport_status tool, which works identically from any agent’s conversation. 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

Other MCP-Compatible Agents

CodeTeleport officially supports Claude Code, Codex, and Antigravity. Its MCP server also follows the Model Context Protocol standard, so any other MCP-compatible client can point at the codeteleport-mcp executable — though only the three agents above are officially supported.

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.