* 目次 [#ye2ad12f]
#context
#contents
* Forgejo MCP環境設定ガイド：Claude DesktopでAIエージェントを強化しよう！ [#pe8d7abb]
** はじめに [#ib2ecc27]
このガイドでは、Claude DesktopにForgejo MCPサーバーを接続する方法を詳しく説明します。公式サイトにはWindows用の設定が書いていないので、実際に試行錯誤して成功した方法をまとめました。AIエージェントの可能性を大幅に広げる、とても有用な設定です！
** Forgejoって何？なぜGitHubじゃダメなの？ [#vc281667]
*** Forgejoとは [#q0c198b2]
Forgejoは、GitHubやGitLabのようなGitホスティングサービスのオープンソース版です。自分のサーバーで動かすことができる「セルフホスト型」のGitプラットフォームです。
*** なぜForgejoを使うの？ [#od2aa499]
''答え：AIエージェントを思いっきり追加できるから！''
- ''GitHubの制限'': GitHubは商用サービスなので、API制限や利用規約があります
- ''Forgejoの自由度'': 自分のサーバーなので、好きなだけAIエージェントを接続できます
- ''プライベート'': 機密性の高いプロジェクトも安心して管理できます
- ''カスタマイズ'': 必要に応じて機能を追加・変更できます
*** AIエージェントの長期記憶として活用 [#w64fe8e4]
Forgejoを使うことで、Claude Desktopがあなたのプロジェクトを「覚えて」おけるようになります：
- ''プロジェクトの進捗管理'': AIがイシューやタスクを追跡
- ''コード履歴の把握'': 過去の変更を理解して、より良い提案ができる
- ''継続的な改善'': プロジェクトの成長をAIと一緒に見守れる
** 必要なもの [#m1fed2fd]
- Windows PC
- Claude Desktop（インストール済み）
- Forgejoサーバー（ローカルまたはリモート）
- Git Bash（推奨）
** ステップ1: Forgejo MCPサーバーの入手 [#scff55e1]
*** GitHubからクローン [#z5b33aa8]
git clone https://github.com/goern/forgejo-mcp.git
*** プロジェクトフォルダに移動 [#gda9152b]
cd forgejo-mcp
** ステップ2: ビルド [#ef3ba025]
*** ビルド実行 [#ofb14110]
make build
このコマンドで&color(blue){forgejo-mcp};という実行ファイルが作成されます。
** ステップ3: Windows用の調整（重要！） [#ee62b735]
&color(red){''ここがポイント！''};Windows CMDでは拡張子のないファイルを実行できないので、ファイル名を変更する必要があります。
*** ファイル名変更 [#i0ba2e3c]
copy forgejo-mcp forgejo-mcp.exe
*** 動作確認 [#of9ab6f3]
.\forgejo-mcp.exe --help
以下のような出力が表示されれば成功です：
Usage of .\forgejo-mcp.exe:
-d debug mode (default true)
-debug
debug mode (default true)
-host string
Forgejo host (default "https://forgejo.org")
-port int
sse port (default 8080)
-t string
Transport type (stdio or sse) (default "stdio")
-token string
Your personal access token
-transport string
Transport type (stdio or sse) (default "stdio")
*** 環境変数の設定（推奨） [#m7aee2a2]
&color(blue){forgejo-mcp.exe};のパスをWindows環境変数PATHに追加しておくと、フルパスを指定しなくても実行できるようになります。
+ Windowsキー + Rで「ファイル名を指定して実行」を開く
+ &color(blue){sysdm.cpl};と入力してEnter
+ 「詳細設定」タブ → 「環境変数」
+ システム環境変数の「Path」を選択 → 「編集」
+ &color(blue){forgejo-mcp.exe};があるフォルダのパスを追加
** ステップ4: Claude Desktop設定 [#k552433a]
*** 設定ファイルの場所 [#o96a046a]
Claude Desktopの設定ファイルを開きます：
%APPDATA%\Claude\claude_desktop_config.json
*** 設定内容の追加 [#z4d2958e]
以下の設定を追加します：
{
"mcpServers": {
"forgejo": {
"command": "forgejo-mcp.exe",
"args": [
"-t", "stdio",
"--host", "http://localhost:3000"
],
"env": {
"GITEA_HOST": "http://localhost:3000",
"GITEA_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}
*** 設定内容の説明 [#lfe5fc9e]
- &color(blue){command}: 実行ファイル名（環境変数に追加した場合はファイル名のみでOK）
- &color(blue){args}:
-- &color(green){-t stdio}: 標準入出力での通信を指定
-- &color(green){--host}: ForgejoサーバーのURL
- &color(blue){env}:
-- &color(green){GITEA_HOST}: Forgejoサーバーのホスト
-- &color(green){GITEA_ACCESS_TOKEN}: アクセストークン（Forgejoで生成）
*** アクセストークンの取得方法 [#b472d54a]
+ Forgejoにログイン
+ 右上のプロフィール → 「設定」
+ 「アプリケーション」 → 「アクセストークン」
+ 新しいトークンを生成
+ 生成されたトークンを上記設定の&color(red){your_access_token_here};部分に入力
** ステップ5: 動作確認 [#p498734d]
*** Claude Desktopの再起動 [#oc3fe3fa]
設定を保存したら、Claude Desktopを完全に再起動します。
*** 接続確認 [#tf2de9b5]
Claude Desktopを開いて、新しい会話で以下を試してみてください：
- 「Forgejoのリポジトリ一覧を教えて」
- 「新しいイシューを作成して」
- 「プルリクエストの状況は？」
** よくある問題と解決方法 [#had44462]
*** Q: 「ENOENT」エラーが出る [#jdf0230e]
''A'': ファイルパスが間違っている可能性があります。環境変数の設定を確認してください。
*** Q: 接続できない [#td29b12c]
''A'': 以下を確認してください：
- Forgejoサーバーが起動しているか
- アクセストークンが正しいか
- ホストURLが正しいか
*** Q: Windowsで実行できない [#a73027c0]
''A'': ファイル名を&color(blue){forgejo-mcp.exe};に変更したか確認してください。
** AIエージェントでできること [#c9b4e8f8]
Forgejo MCPを設定すると、Claude Desktopでこんなことができるようになります：
*** プロジェクト管理 [#md6dd0f8]
- ''自動イシュー作成'': 「バグを見つけたからイシューを作って」
- ''プルリクエスト管理'': 「このPRをレビューして」
- ''プロジェクト進捗確認'': 「今週の作業状況は？」
*** コード支援 [#f0878ec2]
- ''コードレビュー'': AIがコードの品質をチェック
- ''バグ修正提案'': 問題のあるコードに対する改善案
- ''ドキュメント生成'': READMEやコメントの自動生成
*** 長期記憶の活用 [#ff6bd1f4]
- ''過去の決定の記録'': なぜその実装にしたかをAIが覚えている
- ''継続的改善'': プロジェクトの成長をAIと一緒に追跡
- ''知識の蓄積'': チーム内のノウハウをAIが学習
** まとめ [#b9b3cfb1]
Forgejo MCPを設定することで、Claude Desktopがあなたのプログラミングパートナーとして大幅にパワーアップします。公式ドキュメントにWindows設定がなくて苦労しましたが、この手順で確実に動作するはずです。
AIエージェントの可能性は無限大！ぜひ試してみて、プログラミングライフをより楽しく、より効率的にしましょう！
----
&color(red){''注意''}: セキュリティのため、アクセストークンは絶対に他人と共有しないでください。また、定期的にトークンを更新することをお勧めします。
