Switchy
Open app
Guide

Connect GitHub

One-click OAuth, then bind to a Space, then teammates can search repos and find PRs from the chat composer with @github.

Setup

  1. Open Settings → MCP integrations.
  2. Under One-click integrations, click Connect GitHub.
  3. GitHub asks you to authorise Switchy. Scopes requested: read:org, repo, read:user. Approve.
  4. You land back on Switchy with a green confirmation. The connector now appears as @github in the connected list.

Tokens go into Google Secret Manager — not into Postgres, not into logs.

Bind to a Space

  1. Open the Space you want GitHub reachable from.
  2. Go to Space settings → MCP integrations.
  3. Toggle @github on.

Repeat for every Space that should have access. Org admins manage the connector list; Space admins (Project OWNER/EDITOR or org OWNER/ADMIN) toggle bindings.

Use it

From the composer in a Space where @github is bound, mention it with a question:

  • "@github what issues are open about authentication?"
  • "@github any open PRs from me right now?"
  • "@github @claude summarise the top 5 issues in our infra repo."

Switchy calls GitHub's API on your behalf, truncates the result to 50 KB, and feeds it into the LLM agent in the same turn. The agent replies with a summary that references the actual data — not a hallucination.

Tools available

  • search_repos — public + accessible private repos by query.
  • search_issues — issues + PRs across repos the connection can see.
  • get_repo — repo metadata (stars, default branch, language, topics).
  • list_my_pull_requests — open PRs authored by the actor.

The AI picks the tool automatically based on your question. You don't need to specify which one.

Health + outages

Switchy probes the GitHub connector every 10 minutes. The composer's @ menu shows current status — Healthy, Slow (5–30s response), or Offline. If GitHub goes down, we email org OWNERS once that day with a link back to the integration.

Troubleshooting

  • Connect button returns 503. The operator hasn't set GITHUB_OAUTH_CLIENT_ID + GITHUB_OAUTH_CLIENT_SECRET on this deployment yet.
  • OAuth fails on GitHub's side. Check the OAuth app's callback URL is https://switchy.build/api/mcp/oauth/callback exactly.
  • @github not in the autocomplete. The Space doesn't have it bound. Check Space settings → MCP integrations.
  • Reply says "rate limited". GitHub returned 429. Wait the suggested period; it's a per-token quota.

Next

←PreviousMemory best practicesNextConnect Notion→