MCP（Model Context Protocol）

MCP は、Claude Code を 外部ツールやサービスと連携 させるためのプロトコルです。Slack、Jira、データベースなど、さまざまなツールと接続できます。

MCP とは

MCP（Model Context Protocol）は、AI モデルが外部のツールやデータソースと通信するための 標準化されたプロトコル です。

従来:
  Claude Code → コードの読み書きのみ

MCP を使うと:
  Claude Code → Slack のメッセージを読む
             → Jira のチケットを取得する
             → データベースにクエリを実行する
             → ファイルシステムにアクセスする

Anthropic 公式の仕組み

MCP は Anthropic が策定したオープンプロトコルです。Claude Code だけでなく、Claude Desktop など他の Anthropic 製品でも同じ仕組みが使えます。

MCP の仕組み

MCP は「サーバー」と「クライアント」のモデルで動作します。

┌──────────────┐     ┌──────────────────────┐     ┌────────────┐
│  Claude Code │ ←→  │  MCP サーバー          │ ←→  │  外部ツール  │
│ （クライアント）│     │ （ブリッジ役）          │     │ Slack, Jira │
└──────────────┘     └──────────────────────┘     └────────────┘

要素	役割
クライアント	Claude Code 本体。MCP サーバーに接続する側
MCP サーバー	外部ツールとの橋渡しをするプログラム
外部ツール	Slack、Jira、データベースなどの実際のサービス

MCP の設定方法

Step 1: MCP サーバーを設定ファイルに追加

MCP サーバーは .claude/settings.json または ~/.claude/settings.json で設定します。

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token"
      }
    }
  }
}

トークンの管理

API トークンや認証情報は、設定ファイルに直接書くのではなく、環境変数を使って管理することを推奨します。.claude/settings.json を .gitignore に追加するか、個人用の ~/.claude/settings.json に記載しましょう。

Step 2: Claude Code を再起動

設定ファイルを変更したら、Claude Code を再起動して MCP サーバーを読み込みます。

# Claude Code を終了して再起動
> /exit
$ claude

Step 3: MCP ツールを使う

MCP サーバーが正常に接続されると、Claude Code から外部ツールを使えるようになります。

# Slack のメッセージを読む
> Slack の #dev チャンネルの最新メッセージを確認して

# Jira のチケットを取得
> Jira の PROJ-123 チケットの内容を教えて

よく使われる MCP サーバー

Slack

チームのコミュニケーションツールと連携します。

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token"
      }
    }
  }
}

できること:

• チャンネルのメッセージを読む
• メッセージを送信する
• スレッドの内容を確認する

# 使用例
> Slack の #development チャンネルで今日報告されたバグを確認して
> 修正が完了したことを Slack の #dev に報告して

ファイルシステム

追加のディレクトリにアクセスする MCP サーバーです。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/allowed/dir"]
    }
  }
}

GitHub

GitHub の Issue や PR と連携します。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your-token"
      }
    }
  }
}

できること:

• Issue の作成・更新
• PR の作成・レビュー
• リポジトリの情報取得

コミュニティ製の MCP サーバー

Anthropic 公式以外にも、コミュニティが作成した MCP サーバーが多数あります。Jira、Notion、Google Drive、PostgreSQL など、さまざまなツール向けの MCP サーバーが公開されています。

MCP 活用の実践例

例 1: Slack + コード修正の連携

> Slack の #bug-reports チャンネルから最新のバグ報告を確認して、
  対応可能なものがあれば修正してください

Claude は以下のことを自動で行います。

1. Slack からバグ報告を取得
2. 報告された問題をコードベースで調査
3. 修正を実施
4. 結果を Slack に報告

例 2: Jira + 開発フロー

> Jira の PROJ-456 の要件を読んで、
  実装に必要なファイルと変更箇所を教えてください

例 3: データベース連携

> 開発データベースの users テーブルのスキーマを確認して、
  それに合った TypeScript の型定義を作成してください

MCP サーバーの管理

接続状態の確認

# Claude Code 内で MCP の状態を確認
> /mcp

/mcp コマンド

/mcp コマンドを実行すると、接続中の MCP サーバーの一覧と状態を確認できます。

トラブルシューティング

問題	対処法
MCP サーバーが接続できない	設定ファイルのパスとコマンドを確認
認証エラー	トークンが有効か確認
タイムアウト	ネットワーク接続を確認

MCP サーバーのデバッグ

MCP サーバーの動作がおかしい場合は、直接コマンドを実行してエラーを確認できます。

# MCP サーバーを直接実行してログを確認
npx -y @anthropic/mcp-server-slack

セキュリティの考慮事項

セキュリティに注意

MCP を使うと Claude Code が外部サービスにアクセスできるようになります。以下の点に注意してください。

1. 最小権限の原則 - 必要な権限だけを付与する
2. トークン管理 - API トークンは安全に管理する
3. アクセス制限 - 読み取り専用のトークンを使うことを検討
4. ログの確認 - MCP 経由の操作のログを定期的に確認

まとめ

項目	内容
MCP とは	AI と外部ツールを接続する標準プロトコル
設定場所	.claude/settings.json または ~/.claude/settings.json
主な連携先	Slack、GitHub、Jira、データベースなど
注意点	トークン管理とセキュリティに配慮する

これで Step 5 のカスタマイズは完了です。次は、チーム開発を効率化する Step 6: チーム開発 に進みましょう。