Other apps

Any app that supports remote MCP servers over HTTP can connect to Githome. Apps that support MCP's OAuth sign-in need only the URL; the rest send a token.

https://git.pkgforge.dev/mcp

#Cursor

Add Githome to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project to share it with everyone who opens the project:

{
  "mcpServers": {
    "githome": { "url": "https://git.pkgforge.dev/mcp" }
  }
}

Cursor lists the server in its MCP settings with a way to sign in; Githome's consent page opens in your browser.

To clone Githome repositories in Cursor, use the plain HTTPS clone URL of the repository. Githome ships no editor extension.

#VS Code

Add Githome to .vscode/mcp.json in a workspace (or run MCP: Add Server from the Command Palette and choose HTTP):

{
  "servers": {
    "githome": { "type": "http", "url": "https://git.pkgforge.dev/mcp" }
  }
}

Start the server from the file or the MCP view, and sign in when VS Code asks.

To clone Githome repositories in VS Code, use Git: Clone with the repository's plain HTTPS clone URL, and run githome auth setup-git once so git pushes with your Githome sign-in. Githome ships no editor extension.

#Any other app

Look for "remote MCP server", "HTTP" or "Streamable HTTP" in the app's settings, and give it https://git.pkgforge.dev/mcp. If the app supports OAuth for MCP, it finds everything else on its own: Githome answers its first request with a 401 that points at the sign-in details, the app registers itself, and you approve it on the consent page. See How sign-in works.

#Apps without OAuth sign-in

Send a Githome token in the Authorization header instead. Use an agent's token (created under Settings → Agents) and keep it in an environment variable, never in a file you commit:

{
  "mcpServers": {
    "githome": {
      "url": "https://git.pkgforge.dev/mcp",
      "headers": { "Authorization": "Bearer ${GITHOME_TOKEN}" }
    }
  }
}

githome mcp-config prints this snippet. Apps that can only start local (stdio) servers, such as those set up through Claude Desktop's configuration file, can reach Githome through a small bridge; MCP server has the setup for those and for many more clients.

#Check that it works

Ask the app "Who am I on Githome?". It calls the whoami tool and answers with the account it acts as. Apps that signed in also show under Settings → Access tokens → Connected apps on Githome.