Gitea MCPでCursorと連携：ファイルとコミット

💡 インストール不要です。cloud.anythingmcp.com をそのままお使いください。 サインインして Connectors → Gitea をクリックし、認証情報を貼り付けて、MCP APIキーを発行すれば完了です。Docker も git clone もローカルサーバーも不要です。

Gitea + Cursor

AIにGiteaを読み取らせましょう。リポジトリの検索、コメント・ファイル・差分・レビューを含むイシューとプルリクエストのトリアージ、リリースと組織の確認、ブランチ・コミット・ファイルの読み取りができます。gitea.comでも自前のGiteaサーバーでも、アクセストークンで利用できます。読み取り専用です。

前提条件

コネクターに組み込まれている完全なセットアップ手順を参照してください(アプリ内ストアでコネクターを選択すると表示されます)。このコネクターに必要な環境変数は次のとおりです。

GITEA_URL, GITEA_TOKEN

ステップ1 — 認証情報を取得する

セットアップには約2分かかります。gitea.comまたは自前のGiteaサーバーのアカウントと、Repository、Issue、Organization、Userに対する Read 権限を持つアクセストークンが必要です。

1. Giteaでアバターをクリックし、Settings、Applications の順に進みます。Manage Access Tokens で名前(例: 「AnythingMCP」)を入力し、Repository、Issue、Organization、User を Read に設定します(スコープは read:repository、read:issue、read:organization、read:user です)。トークンのスコープに対応していないバージョンのGiteaでは、トークンにそのユーザーの全権限が付与されます。
2. Generate Token をクリックし、すぐにトークンをコピーします。Giteaがトークンを表示するのは一度だけです。GITEA_TOKEN には、先頭に token や Bearer を付けず、トークンだけを貼り付けてください。コネクターが自動で token を付加します。
3. GITEA_URL には、Giteaを開くアドレスを設定します。例: https://gitea.com や https://git.example.com。/api/v1 や末尾のスラッシュは付けないでください。Giteaがサブパスで動作している場合は、そのまま残します(https://example.com/gitea)。
4. コネクターをインストールして gitea_get_current_user を実行します。トークンの所有ユーザーが表示され、アドレスとトークンが正しく動作することを確認できます。

読み取り専用: 30個のツールはすべて読み取りのみを行います。コネクターはGitea上で何かを作成、変更、削除することはできず、AIにはトークンのユーザーが閲覧できる内容がそのまま見えます。

読み取れる内容: リポジトリ(インスタンス全体の検索、または自分・組織・他のユーザーの一覧)、コメント・ラベル・マイルストーン付きのイシュー、変更ファイル・差分・コミット・レビュー付きのプルリクエスト、ノートと添付ファイル付きのリリース、メンバーとチーム付きの組織、ブランチ、コミット、ファイルツリー、ファイルの内容です。gitea_search_issues は、自分に割り当てられた、自分が作成した、または自分のレビュー待ちのイシューとプルリクエストを、すべてのリポジトリから検索します。

リポジトリと番号: すべてのリポジトリは owner(ユーザーまたは組織)と repo を取ります。これは https://host/owner/repo の2つの部分です。イシューとプルリクエストは、リポジトリごとに1つの番号体系を共有します。Giteaはプルリクエストをイシューとしても扱うため、gitea_get_issue と gitea_list_issue_comments はプルリクエスト番号でも動作し、タイトル、ラベル、会話を取得できます。コード側は gitea_get_pull_request、gitea_get_pull_request_files、gitea_get_pull_request_diff で取得します。

自前のサーバー: 内部ホスト(プライベートIPや内部名)上のGiteaを使うには、同じネットワーク内にセルフホストのAnythingMCPが必要です。さらにホスト名を SSRF_ALLOWED_HOSTS に追加しないと、送信ガードが呼び出しをブロックします。Forgejoと、それを実行しているCodebergも同じAPI v1ルートを提供しているため、https://codeberg.org のようなアドレスでも動作するはずです。このコネクターはGitea APIを対象に作られています。

制限: Giteaサーバーはデフォルトで1ページあたり30件、最大50件(MAX_RESPONSE_ITEMS 設定)を返すため、AIはlimitを大きくするのではなく次のページを要求します。200 KBを超えるプルリクエストの差分とファイル内容は切り詰められます。残りはプルリクエストの html_url を開いて確認してください。

よくあるエラー: 401はトークンが間違っている、期限切れ、または削除されている、あるいは GITEA_URL が別のサーバーを指していることを意味します。403は、呼び出しに必要なスコープがトークンにないことを意味します(Giteaがメッセージで名前を示します)。例えば、イシューには read:issue、組織には read:organization が必要です。404は、リポジトリ、イシュー、ファイルが存在しない、またはユーザーが閲覧できないことを意味します。Giteaは非公開リソースを隠すために404を返します。422は、不足している、または無効なフィールドを示します。

このコネクターは、イシュー、コメント、プルリクエスト、リリース、ブランチ、ファイルの作成や編集、マージや承認を行いません。また、Actionsの実行とワークフロー、パッケージ、Wiki、通知、Webhook、デプロイキー、管理機能は対象外です。

ステップ2 — アダプターをインストールする

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ3 — Cursorにコネクターを追加する

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう — エージェントが Gitea のツールを呼び出せるようになりました。

利用可能なツール

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい — MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクターのランディングページ
• Claudeに接続する
• ChatGPTに接続する