A personal collection of dotfiles and scripts for syncing settings across machines.
dotfiles docs MCP.md
3.6 kB · 60 lines
Markdown
at main

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. ~/.pi links to .pi/ in this repo.
  • Claude Code
    • Uses the GitHub plugin from Anthropic's official marketplace. Install it with /plugin install github@claude-plugins-official and choose user scope.
    • Plugin settings and installed files are managed by Claude Code, not this repo.
  • Cursor
    • Reads: ~/.cursor/mcp.json
    • Source: .cursor/mcp.json, linked by bin/link.sh and edited by hand.
  • Droid
    • Reads: ~/.factory/mcp.json
    • Source: factory/mcp.json, linked by bin/link.sh. It uses Droid's native schema, with enabledTools in place of Pi's directTools.
  • Devin
    • Reads: ~/.config/devin/mcp_config.json
    • Source: devin/mcp.json, linked by bin/link.sh. It uses Devin's native schema (url/transport/headers) and has no tool allowlist, so every server exposes all its tools.

Changing a server #

  1. Edit each config: update .agents/mcp.json and factory/mcp.json with ${VAR} placeholders, and .cursor/mcp.json and devin/mcp.json with ${env:VAR}.
  2. Claude Code: install or manage the GitHub plugin with /plugin. just mcp removes legacy user-scope MCP entries named exa, firecrawl, and github; it does not sync .agents/mcp.json to Claude Code. just run also runs this cleanup.
  3. Reload: use /reload in pi, start a new Claude Code session, restart Cursor, and use /mcp in 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 #