Forgejo MCP環境設定ガイド
をテンプレートにして作成
[
トップ
] [
新規
|
一覧
|
単語検索
|
最終更新
|
ヘルプ
]
開始行:
* 目次 [#ye2ad12f]
#contents
* Forgejo MCP環境設定ガイド：Claude DesktopでAIエージェン...
** はじめに [#ib2ecc27]
このガイドでは、Claude DesktopにForgejo MCPサーバーを接続...
** Forgejoって何？なぜGitHubじゃダメなの？ [#vc281667]
*** Forgejoとは [#q0c198b2]
Forgejoは、GitHubやGitLabのような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}: 実行ファイル名（環境変数に追加し...
- &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}: アクセストークン（F...
*** アクセストークンの取得方法 [#b472d54a]
+ Forgejoにログイン
+ 右上のプロフィール → 「設定」
+ 「アプリケーション」 → 「アクセストークン」
+ 新しいトークンを生成
+ 生成されたトークンを上記設定の&color(red){your_access_t...
** ステップ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があなたのプロ...
AIエージェントの可能性は無限大！ぜひ試してみて、プログラ...
----
&color(red){''注意''}: セキュリティのため、アクセストーク...
終了行:
* 目次 [#ye2ad12f]
#contents
* Forgejo MCP環境設定ガイド：Claude DesktopでAIエージェン...
** はじめに [#ib2ecc27]
このガイドでは、Claude DesktopにForgejo MCPサーバーを接続...
** Forgejoって何？なぜGitHubじゃダメなの？ [#vc281667]
*** Forgejoとは [#q0c198b2]
Forgejoは、GitHubやGitLabのような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}: 実行ファイル名（環境変数に追加し...
- &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}: アクセストークン（F...
*** アクセストークンの取得方法 [#b472d54a]
+ Forgejoにログイン
+ 右上のプロフィール → 「設定」
+ 「アプリケーション」 → 「アクセストークン」
+ 新しいトークンを生成
+ 生成されたトークンを上記設定の&color(red){your_access_t...
** ステップ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があなたのプロ...
AIエージェントの可能性は無限大！ぜひ試してみて、プログラ...
----
&color(red){''注意''}: セキュリティのため、アクセストーク...
ページ名:
