Claude.ai
Connect Pharaoh to Claude.ai so it sees your codebase architecture in every conversation.
Prerequisite: Install the GitHub App first.
Setup
Open the Claude desktop app
Go to Settings > MCP Servers
Click Add
Enter the URL:
https://mcp.pharaoh.so/sseComplete the GitHub OAuth flow in the browser window that opens
Authorize with the GitHub account that has the Pharaoh app installed
MCP servers require the Claude desktop app. The browser-only version of Claude.ai does not support MCP.
Verify
Start a new conversation and ask:
What modules does my codebase have? Use get_codebase_map.Claude should return a module breakdown with file counts, function counts, and dependency relationships.
What happens automatically
Claude calls Pharaoh tools before making architectural decisions - checking for duplicate functions, understanding callers, mapping module boundaries
Every push to your default branch refreshes the graph within minutes
No config files or per-repo setup needed after the initial install
Pharaoh tools return structured data in minimal tokens so Claude has room to reason
Troubleshooting
"MCP server fails to connect": MCP requires the Claude desktop app. If you're using Claude in a browser tab, download the desktop app from claude.ai/download.
Tools appear but return no data: The GitHub App must be installed and mapping must be complete. Check your Pharaoh dashboard or wait 1-3 minutes after installing the app for initial mapping to finish.
OAuth redirect loop or authorization error: Clear your browser cookies for mcp.pharaoh.so, then try again. If that fails, try in an incognito window to rule out extension interference.
Wrong repos showing up: Pharaoh maps the repos your GitHub App installation covers. To change which repos are included, go to GitHub > Settings > Applications > Pharaoh > Configure.
Last updated