Skip to main content
Version: Classic 2.1.0

Setup Guide

Get RepoPrompt's MCP server connected to your preferred AI tool in minutes. The server enables external agents to use RepoPrompt's powerful context building, code intelligence, and editing capabilities.

Quick Setup​

  1. Open Settings → MCP Server
  2. Enable the MCP Server toggle
  3. Click the install button for your client (or copy configuration)
  4. Restart your client and approve the connection in RepoPrompt

Client-Specific Instructions​

Cursor (One-Click)​

  1. Open Settings → MCP Server in RepoPrompt
  2. Click "Install in Cursor"
  3. Restart Cursor
  4. When Cursor connects, approve in RepoPrompt (check menu bar for dialog)

Claude Code​

  1. Open Settings → MCP Server in RepoPrompt
  2. Click "Copy Configuration"
  3. Open Claude Code's MCP settings (claude mcp add or edit config file)
  4. Paste the configuration
  5. Restart Claude Code
  6. Approve the connection when prompted in RepoPrompt

Codex CLI (One-Click)​

  1. Open Settings → MCP Server in RepoPrompt
  2. Click "Install for Codex"
  3. This automatically configures your codex.toml with extended timeouts
  4. Restart Codex and approve the connection

Other MCP Clients​

  1. Open Settings → MCP Server
  2. Click "Copy Configuration" to get the JSON config
  3. Add to your client's MCP server configuration
  4. The client will launch repoprompt-mcp automatically via stdio
  5. Approve the connection in RepoPrompt

Configuration Format​

The copied configuration follows the MCP standard format:

{
  "mcpServers": {
    "repoprompt": {
      "command": "/Applications/RepoPrompt.app/.../repoprompt-mcp",
      "args": []
    }
  }
}

The exact path varies by installation. Always use the "Copy Configuration" button to get the correct path for your system.

Connection Approval​

When a client first connects, RepoPrompt shows an approval dialog. You can:

  • Allow Once: Permit this single session
  • Always Allow: Add to allowlist (recommended for trusted clients)
  • Deny: Reject the connection
tip

Tip: The approval dialog appears in the menu bar area. If you don't see it, check that RepoPrompt has focus or look for a notification.

Verifying the Connection​

Once connected, you'll see the connection status in RepoPrompt's toolbar:

  • Connected: [Client Name] - Ready to receive tool calls
  • Animated icon - Tool call in progress

Test the connection by asking your agent to list files or get the workspace context. In Claude Code, try: "Use RepoPrompt to show me the file tree."

Transport Mode​

If you're in a corporate environment with strict firewall policies, switch toFilesystem transport in Settings. This uses file-based message passing instead of localhost TCP connections.

See Transport Modes documentation for details on when and why to use each mode.

Troubleshooting Setup​

Client can't find repoprompt-mcp​

  • Re-copy the configuration - paths are system-specific
  • Ensure RepoPrompt is installed in /Applications
  • Check that the CLI binary exists at the configured path

No approval dialog appears​

  • Ensure MCP Server is enabled in Settings
  • Check the menu bar for pending approval notifications
  • Try toggling the server off and on

Connection keeps dropping​

  • Try switching to Filesystem transport mode
  • Check if antivirus software is interfering
  • Ensure no VPN is redirecting localhost traffic

Tools not appearing in client​

  • Check Settings → MCP Server → Tools to ensure tools are enabled
  • Restart the client after enabling tools
  • Verify the connection is active (check status indicator)
tip

Next Steps: Once connected, explore the Tools Reference to see all available capabilities, or check Connection Management to learn about multi-window mode and tab binding.