GitCafe MCP Server

GitCafe MCP Server とは？

GitCafe MCP Server は、GitCafe が公式にホストするエンドポイント（https://git.cafe/mcp）で、Claude や ChatGPT などの AI クライアントがリポジトリを読み取り、あなたの承認のもとで issue、pull request、レビューを扱えるようにします。

GitCafe は、スタック型 pull request、GitHub とのオプションの双方向同期、cafe CLI を備えた Git ホスティング兼コードレビューサービスです。GitCafe MCP Server は GitCafe 自身が運営しています。公開リポジトリはサインインなしで読み取れます。OAuth でサインインすると、承認したリポジトリと権限の範囲内で、プライベートリポジトリと書き込み系ツールが使えるようになります。

GitCafe MCP Server の使い方

サーバーは Streamable HTTP トランスポートを使用し、URL は次のとおりです。

https://git.cafe/mcp

読み取り系ツールは公開リポジトリに対して匿名で使えます。書き込み系ツールと get_me はサインインを開始します。クライアントがブラウザを開き、認証済みの GitCafe アカウントでサインインし、最大 50 個のリポジトリを選び、権限を確認して（読み取りはオン、書き込みと管理は初期状態でオフ）、Approve connection を選びます。GitCafe のドキュメントでは、トークンやパスワードをコネクタ設定に貼り付けないよう注意しています。サインインはブラウザのフローで行われます。

Claude Code

claude mcp add --transport http gitcafe https://git.cafe/mcp

プライベートリポジトリや書き込み権限が必要になったら、Claude Code で /mcp を実行してサインインします。

Claude Desktop / claude.ai

Customize → Connectors → Add → Add custom connector を開き、名前と https://git.cafe/mcp を入力します。検出されたサインインと自動登録のオプションはそのままにして、Add → Connect を選び、接続を承認します。GitCafe は、各呼び出しを確認できるようツールを Needs approval のままにしておくことを推奨しています。

Cursor

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "gitcafe": {
      "url": "https://git.cafe/mcp"
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "gitcafe": {
      "type": "http",
      "url": "https://git.cafe/mcp"
    }
  }
}

GitCafe は ChatGPT での設定方法も案内しています。開発者モードを有効にし、この URL で MCP アプリを作成して OAuth を選んだままにします。

GitCafe MCP Server の主な機能

• GitCafe がホストする公式サーバーで、ローカルで何かを動かす必要はありません。
• 公開リポジトリへの匿名読み取り：コード、ブランチとタグ、issue、pull request、レビュー、CI の結果。
• OAuth 接続は、選択したリポジトリ（最大 50 個）と付与した権限に限定され、書き込みと管理は初期状態でオフです。
• pull request の一連の作業：diff の読み取り、行単位のコメント、レビューの提出、スレッドの解決、マージ（マージには pr:merge:write 権限が必要）。
• issue 管理：作成、編集、クローズ、再オープン、コメント。
• Buildkite の実行、チェック、ジョブ、ログ末尾による CI の確認。
• すべての操作にリポジトリのルールが適用され、アプリはコミットのプッシュ、ブランチの作成、CI の開始、リポジトリの削除はできません。
• 接続の有効期間は 30 日で、Settings → Authorized Apps からいつでも取り消せます。

GitCafe MCP Server のツール

エンドポイントを調べたところ、21 個のツールが返されました。

• ID とリポジトリ：get_me は接続がどの ID として動作し、何にアクセスできるかを示します。list_repositories と get_repository でリポジトリとそのデフォルトブランチを見つけます。
• コード：list_refs、list_tree、read_file、search_code で、任意の ref のブランチ、タグ、ディレクトリ、ファイルを参照し、リテラル文字列検索を行います。
• Issue：list_issues、issue_read、create_issue、update_issue。
• Pull request：list_pull_requests、pull_request_read、get_pull_request_diff、create_pull_request、update_pull_request、submit_review、merge_pull_request。
• コメント：add_comment は issue、pull request の会話、diff の行にコメントを投稿します。update_comment はコメントの編集やスレッドの解決を行います。
• CI：ci_read は Buildkite の実行、チェック、ジョブ、ログを読み取ります。

書き込み系ツールは期待するバージョンを受け取るため、古い状態での書き込みは他人の変更を上書きせずに失敗します。merge_pull_request はマージ完了前に accepted を返すことがあるので、エージェントは completed になるまで状態を確認する必要があります。

GitCafe MCP Server のユースケース

• 見慣れない公開リポジトリの調査：「このリポジトリのリトライ処理がどこにあるか探して説明して。」
• pull request のレビュー：「PR 42 の diff を読んで、リスクのある変更に行コメントを付け、テストがなければ変更を依頼して。」
• issue の整理：「login に言及しているオープンな issue を一覧にして、重複にラベルを付けて。」
• CI の確認：「この pull request の最新の実行はなぜ失敗した？失敗したジョブのログ末尾を見せて。」
• スタックのマージ：「PR 18 を現在の head で承認し、チェックが通ったらマージして。」

GitCafe MCP Server のトラブルシューティング

• プライベートリポジトリが表示されない：匿名アクセスは公開リポジトリのみが対象で、接続も選択したリポジトリだけが対象です。接続後に作成したリポジトリは含まれないため、再接続して追加してください。
• 1 か月後にツールが動かなくなった：接続の有効期間は 30 日です。クライアントから再接続してください。
• REST API のトークンが拒否される：REST API と MCP のトークンは別物で、相互に使えません。MCP サーバーには MCP のサインインフローで接続してください。
• レート制限にかかった：サインイン済みの MCP リクエストはアカウントの API 枠（60 秒あたり 1,000 回、プランに応じて倍増）に計上されます。匿名リクエストはアドレスごとに 1 時間あたり 1,200 回までです。