MCPサーバーを「1つのツール専用」で使っていませんか？複数サービスを横断接続した瞬間、Claude Codeは単なるコード生成ツールから**「開発プロセス全体を動かすエージェント」**に進化します。
この記事でわかること
結論：GitHub・Notion・SlackのMCPサーバーを同時接続すると、「Issue起票 → 実装 → PR作成 → Slack通知 → Notionタスク更新」の一連のワークフローをClaude Codeが自律的に実行できるようになります。 構築にかかる時間は、各サービスのAPIトークンが揃っていれば約1日です。
この記事では、以下を実際の設定ファイル付きで解説します。
- 3つのMCPサーバーのセットアップ手順と権限設計
- Claude Codeからの統合呼び出し方法（CLAUDE.mdの設計含む）
- 本番運用で踏むハマりどころと対策
環境・前提条件
| 項目 | バージョン / 要件 |
|---|---|
| Claude Code | 最新版（CLIでインストール済み） |
| Node.js | v18以上 |
| GitHub | Personal Access Token（Fine-grained推奨） |
| Notion | Internal Integration Token |
| Slack | Bot Token（xoxb-）+ App Manifest |
| OS | macOS / Linux（Windowsの場合はWSL2推奨） |
1. 完成イメージ — 全自動開発ワークフロー
まず、最終的にどんな体験になるのかを示します。
開発者が一言指示するだけで、4つのサービスを横断した処理が一気に完了します。
2. MCPサーバーの基本アーキテクチャとマルチツール接続の仕組み
MCPとは
MCP（Model Context Protocol）は、AIモデルが外部ツールやデータソースと安全に通信するための標準プロトコルです。各MCPサーバーは「どんな操作ができるか（ツール定義）」をClaude Codeに公開し、Claude Codeが必要に応じて呼び出します。
マルチ接続のアーキテクチャ
重要なポイントは以下の3つです。
- 各MCPサーバーは独立したプロセスとして動作し、Claude Codeがstdio経由で通信する
- Claude Codeは複数のMCPサーバーを同時に認識でき、タスクに応じて適切なサーバーのツールを呼び分ける
- 認証情報は各MCPサーバーが個別に管理するため、Claude Code本体にAPIキーを渡す必要がない
3. ステップ1：GitHub MCP Serverのセットアップ
3-1. トークンの発行
GitHub > Settings > Developer settings > Fine-grained personal access tokens で発行します。
推奨スコープ（最小権限の原則）：
| スコープ | 用途 |
|---|---|
contents: read/write |
ブランチ作成・コードプッシュ |
pull_requests: read/write |
PR作成・更新 |
issues: read/write |
Issue読み取り・コメント |
metadata: read |
リポジトリ情報の取得 |
⚠️ Classic tokenでrepoスコープを全開放するのは避けてください。Fine-grainedでリポジトリ単位に絞るのがベストプラクティスです。
3-2. Claude Codeへの登録
claude mcp add github-mcp \
--env GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxx \
-- npx -y @modelcontextprotocol/server-github
3-3. 動作確認
Claude Codeを起動して以下のように聞いてみます。
> リポジトリ my-org/my-app のオープンなIssue一覧を取得して
Issue一覧が返ってくれば接続成功です。
4. ステップ2：Notion MCP Serverでタスク管理DBと双方向同期する
4-1. Notion Internal Integrationの作成
- Notion Integrations で「New integration」を作成
- 「Content Capabilities」で Read content / Update content / Insert content を有効化
- 対象のNotionデータベースページで「コネクト」からこのIntegrationを追加
4-2. データベース設計のポイント
Claude Codeと連携するデータベースは、以下のプロパティを持たせると便利です。
| プロパティ名 | タイプ | 用途 |
|---|---|---|
| Title | タイトル | タスク名 |
| Status | セレクト |
Todo / In Progress / In Review / Done
|
| GitHub Issue | URL | GitHub Issueへのリンク |
| GitHub PR | URL | PRへのリンク |
| Assignee | ピープル | 担当者 |
4-3. Claude Codeへの登録
claude mcp add notion-mcp \
--env OPENAPI_MCP_HEADERS='{"Authorization":"Bearer ntn_xxxxxxxxxxxx","Notion-Version":"2022-06-28"}' \
-- npx -y @notionhq/notion-mcp-server
4-4. 動作確認
> Notionのタスクデータベースから、ステータスが「Todo」のタスク一覧を取得して
タスク一覧が返ってくれば成功です。データベースIDは、Claude Codeが検索ツールで自動的に特定してくれる場合もありますが、CLAUDE.mdに明記しておくとより確実です。
5. ステップ3：Slack MCP Serverで通知・承認フローを組み込む
5-1. Slack Appの作成
Slack API で新規アプリを作成し、以下のBot Token Scopesを付与します。
| スコープ | 用途 |
|---|---|
chat:write |
メッセージ送信 |
channels:read |
チャンネル一覧取得 |
reactions:write |
リアクション追加（承認フロー用） |
users:read |
ユーザー情報取得 |
5-2. Claude Codeへの登録
claude mcp add slack-mcp \
--env SLACK_BOT_TOKEN=xoxb-xxxxxxxxxxxx \
--env SLACK_TEAM_ID=T0XXXXXXX \
-- npx -y @anthropic/mcp-server-slack
5-3. 動作確認
> Slackの #dev-notifications チャンネルに「テスト通知です」と送信して
メッセージが届けば接続完了です。
6. Claude Codeからの統合呼び出し — CLAUDE.mdの設計
すべてのMCPサーバーが接続できたら、CLAUDE.mdで統合的なワークフローを定義します。これがマルチMCP運用の肝です。
6-1. 設定ファイルの確認
.claude/settings.json（またはプロジェクト直下の.mcp.json）に3つのMCPサーバーが登録されていることを確認します。
{
"mcpServers": {
"github-mcp": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
}
},
"notion-mcp": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_xxxxxxxxxxxx\",\"Notion-Version\":\"2022-06-28\"}"
}
},
"slack-mcp": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-server-slack"],
"env": {
"SLACK_BOT_TOKEN": "xoxb-xxxxxxxxxxxx",
"SLACK_TEAM_ID": "T0XXXXXXX"
}
}
}
}
6-2. CLAUDE.mdのプロンプト設計
プロジェクトルートにCLAUDE.mdを配置し、ワークフローのルールを記述します。
# 開発ワークフロー規約
## MCP連携ルール
### GitHub Issue実装フロー
1. 指定されたGitHub Issueの内容を `github-mcp` で取得する
2. Issue番号に基づいてブランチ `feature/issue-{番号}` を作成する
3. 実装完了後、テストを実行してパスすることを確認する
4. PRを作成する（タイトルに `closes #{番号}` を含める）
5. `notion-mcp` でNotionタスクDBの該当タスクのステータスを「In Review」に更新し、PRリンクを記録する
6. `slack-mcp` で #dev-notifications チャンネルにPR作成を通知する
### Notionデータベース情報
- タスクDB ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
- ステータス遷移: Todo → In Progress → In Review → Done
### Slack通知フォーマット
- チャンネル: #dev-notifications
- 形式: 「🚀 PR作成: {PRタイトル} - {PR URL}（Issue #{番号}）」
6-3. 実際の呼び出し例
> Issue #42 の内容を確認して、実装からPR作成、Slack通知、Notion更新まで一気にやって
CLAUDE.mdにフローが定義されているため、Claude Codeはこの一言で以下を自律的に実行します。
7. トラブルシューティングと本番運用Tips
よくあるエラーと対処法
| 症状 | 原因 | 対処 |
|---|---|---|
MCP server connection failed |
npxのキャッシュ問題 |
npx clear-npx-cache 後に再起動 |
| GitHub APIで403 | トークンのスコープ不足 | Fine-grained tokenのPermissionsを確認 |
| Notion APIで400 | データベースIDの指定ミス | NotionのURLからIDをコピーし直す（ハイフン除去不要） |
Slack投稿でchannel_not_found
|
Botがチャンネルに未参加 | Slackチャンネルで /invite @bot名 を実行 |
レート制限への対策
- GitHub: 認証済みで5,000リクエスト/時。通常の開発フローなら問題ないが、大量Issue一括処理時は注意
-
Notion: 3リクエスト/秒の制限あり。バッチ更新時は
CLAUDE.mdに「Notion操作は1件ずつ間隔を空けて」と指示を入れる -
Slack: Tier制に基づく制限。
chat:writeは1秒1メッセージ程度が安全ライン
認証トークンのローテーション
本番運用では、トークンの定期ローテーションが必須です。
# トークン更新時のコマンド例
claude mcp remove github-mcp
claude mcp add github-mcp \
--env GITHUB_PERSONAL_ACCESS_TOKEN=ghp_新しいトークン \
-- npx -y @modelcontextprotocol/server-github
推奨運用：
- GitHub Fine-grained tokenは有効期限を90日以下に設定
- Notion / Slackトークンはローテーション機能がないため、定期的にregenerateして差し替え
- 環境変数で管理し、
.envファイルは.gitignoreに追加
ログ監視
MCPサーバーの通信ログは以下で確認できます。
# macOS
ls ~/Library/Application\ Support/claude/logs/
# Linux
ls ~/.config/claude/logs/
エラー発生時はこのログで、どのMCPサーバーのどのツール呼び出しが失敗したかを特定できます。
まとめ
- MCPサーバーの複数接続により、Claude Codeは「コード生成ツール」から「開発ワークフロー全体を駆動するエージェント」に進化する。 GitHub・Notion・Slackの3つを繋ぐだけで、Issue起票から通知・タスク管理まで一気通貫で自動化できます。
- CLAUDE.mdによるワークフロー定義が成功の鍵。 各MCPサーバーの接続だけでなく、「どの順番で何をするか」をCLAUDE.mdに明文化することで、Claude Codeの行動精度が大幅に向上します。
- 本番運用ではトークン管理とレート制限対策を忘れずに。 Fine-grained tokenによる最小権限の原則、定期ローテーション、ログ監視の3点を押さえれば、安定した運用が可能です。