> For the complete documentation index, see [llms.txt](https://pharaoh.so/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pharaoh.so/docs/connect/headless.md).

# Headless and SSH

Run `npx @pharaoh-so/mcp` where the agent runs. If it cannot open a browser, follow the authorization URL and code it displays in a browser on another device. Complete GitHub authorization there, then return to the agent.

Do not paste access tokens into prompts or commit them to repository configuration. A custom MCP integration must support Pharaoh's authentication flow; a URL alone does not grant repository access.

[Connection checks](/docs/use-pharaoh/troubleshooting.md)