MCP #
Pi uses .agents/mcp.json. Claude Code uses Anthropic's official GitHub plugin instead of syncing that
file. Cursor, Droid, and Devin each have their own MCP config because their formats differ.
Config Locations #
- pi
- Reads:
~/.pi/agent/mcp.json - Source:
.agents/mcp.json, through a relative symlink at.pi/agent/mcp.json.~/.pilinks to.pi/in this repo.
- Reads:
- Claude Code
- Uses the GitHub plugin from Anthropic's official
marketplace. Install it with
/plugin install github@claude-plugins-officialand choose user scope. - Plugin settings and installed files are managed by Claude Code, not this repo.
- Uses the GitHub plugin from Anthropic's official
marketplace. Install it with
- Cursor
- Reads:
~/.cursor/mcp.json - Source:
.cursor/mcp.json, linked bybin/link.shand edited by hand.
- Reads:
- Droid
- Reads:
~/.factory/mcp.json - Source:
factory/mcp.json, linked bybin/link.sh. It uses Droid's native schema, withenabledToolsin place of Pi'sdirectTools.
- Reads:
- Devin
- Reads:
~/.config/devin/mcp_config.json - Source:
devin/mcp.json, linked bybin/link.sh. It uses Devin's native schema (url/transport/headers) and has no tool allowlist, so every server exposes all its tools.
- Reads:
Changing a server #
- Edit each config: update
.agents/mcp.jsonandfactory/mcp.jsonwith${VAR}placeholders, and.cursor/mcp.jsonanddevin/mcp.jsonwith${env:VAR}. - Claude Code: install or manage the GitHub plugin with
/plugin.just mcpremoves legacy user-scope MCP entries namedexa,firecrawl, andgithub; it does not sync.agents/mcp.jsonto Claude Code.just runalso runs this cleanup. - Reload: use
/reloadin pi, start a new Claude Code session, restart Cursor, and use/mcpin Droid or Devin if needed.
Secrets #
GITHUB_PAT is a placeholder in the MCP configs. Pi loads it from ~/.pi/.env.personal before
connecting. Claude Code's GitHub plugin instead expects GITHUB_PERSONAL_ACCESS_TOKEN in the
environment that launches Claude Code. It does not read Pi's env file or the repo's GITHUB_PAT
setting, so the plugin cannot authenticate without that variable. Do not store the token in tracked
files.
Cursor, Droid, and Devin only see the environment they start in. A missing GITHUB_PAT makes their
GitHub MCP server fail to connect. Cursor or Droid started from the Dock may not see shell exports.
For OAuth-backed servers, log in once per tool in each client: /mcp in Claude Code and Droid, or the
MCP settings in Cursor.
Figma #
claude/settings.json enables figma@claude-plugins-official for Claude Code.
The MCP JSON configs for pi, Cursor, Droid, and Devin do not include Figma yet; follow the
Guide to the Figma MCP server
and apply Changing a server to add it.
Docs #
- pi: MCP Servers
- Claude Code: Connect Claude Code to tools via MCP
- Cursor: Model Context Protocol (MCP)
- Droid: Model Context Protocol (MCP)
- Devin: MCP configuration (ships with the CLI under
share/devin/docs/)