見出し画像

文系自分用まとめ　最近Xで流れてくるMCPって何者？

kuyu


まず結論

MCP（Model Context Protocol）とは、AI（Claude、ChatGPT、Geminiなど）と外部サービス（GitHub、Notion、Slackなど）を同じ方法で接続するための共通プロトコルです。
一度MCP対応の接続を作れば、複数のAIから同じ手順でツールを呼び出せるため、開発工数と運用コストが大幅に下がります。
忘れないように復習として、導入から運用までを手順を記録しておく。
すぐバージョン変わるから、結局また都度AIに聞く事になるんだが、、

目次


全体概要（最初に3行で）

MCP（Model Context Protocol）は、AIと外部サービスを同じ方法でつなぐ共通規格です。
一度MCP対応を作れば、Claude・ChatGPT・Geminiなど複数のAIから同じ手順でツールを呼べます。
以下はステップバイステップ導入記録（実作業＋要点＋補足付き）です。

1 全体概要まとめ

  • 目的：AI（クライアント）と外部サービス（サーバー）を統一的に接続する。

  • 仕組み：JSON‑RPCベースで Tools / Resources / Prompts を公開し、stdio（ローカル）か HTTP/SSE（リモート）で通信する。

  • 効果：一度実装すれば複数AIで再利用でき、開発工数と運用コストが下がる。 気づき：主要AIベンダーが採用したことで「学ぶ価値が高い共通技術」になった点が革新的。

【補足（文系向け）】

  • JSON‑RPC：データのやり取りの「決まった書式」。手紙の書式が決まっていると読みやすい、というイメージ。

  • stdio / HTTP / SSE：自分のPC内で完結するか、インターネット越しに接続するかの違いです。

2 導入前チェックリスト（準備物）

  • MCP対応クライアント（例：Claude Code 等）

  • MCPサーバー（既製の @modelcontextprotocol/server-xxx か n8n）

  • ターミナル環境（Node.js・npx が使えること）

  • 認証情報（Bearer トークン等）

  • チーム共有用リポジトリ（.mcp.json を置く場所）

要点：環境が整えば導入は短時間で完了します。個人でも試せる構成を優先。

【補足】

  • ターミナル：黒い画面でコマンドを打つツール。プログラム実行に使います。

3 ステップバイステップ導入手順（実作業）

ステップA：サーバーを用意する（10〜30分）

  1. 既製サーバーを使う場合は配布手順に従って起動。

  2. ローカルで試す例：

bash

npx -y @modelcontextprotocol/server-github

  1. クラウドで常時接続するなら VPS やクラウドサービスにデプロイ。

ポイント：ローカルで動かして動作確認→問題なければクラウドへ移行。

【補足】npx はパッケージを一時実行するコマンド。インストール不要で試せます。

ステップB：認証を設定する（5〜15分）

  1. サーバー側で Bearer トークン を発行。

  2. 必要ならカスタムヘッダーでアクセス制御を追加。

  3. テスト用トークンで動作確認後、本番用に切替。

要点：認証は最初に必ず設定。公開サーバーでは必須。

【補足】Bearer トークンはAPIにアクセスするための「合言葉」です。

ステップC：クライアントに登録する（3〜10分）

  1. Claude Code（リモート）例：

bash

claude mcp add --transport http notion https://mcp.example.com/mcp
claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer your-token"

  1. ローカル stdio 接続例：

bash

claude mcp add --transport stdio github -- npx -y @modelcontextprotocol/server-github

要点：--transport で接続方式を指定。--header で認証ヘッダを渡す。

【補足】claude mcp add は接続先を登録するコマンドです。

ステップD：動作確認（5分）

  1. claude mcp list で接続一覧を確認。

  2. クライアントで /mcp を実行して接続状態を確認。

  3. 自然言語で試す：「GitHubのissue一覧を見せて」→期待通りの応答を確認。

要点：ログにエラーが出たら認証・URL・CORS をチェック。

【補足】CORS はブラウザとサーバー間のアクセス制御ルールです。ブラウザで動かすときに関係します。

4 n8nとMCPを組み合わせる（短手順）

  • n8n（ワークフロー自動化ツール）をMCPの「サーバー側」
    または「クライアント側」として使う方法     と、その結果どんな自動化が可能になるか、

n8nをMCPサーバーにする — 意味とやること（ステップバイステップ）

意味 n8nをMCPサーバーにすると、n8nで作ったワークフロー（作業の流れ）を外部のAI（ClaudeやChatGPTなど）から直接呼び出せるようになります。AIが「そのワークフローを実行して」と命令すると、n8nが受け取って処理を始めます。

やること（手順）

  1. n8nを起動してワークフロー編集画面を開く。

  2. ワークフローに MCP Server Trigger ノードを追加する。

  3. ノードが生成する「MCP用のURL（エンドポイント）」をコピーする。

  4. そのURLをAI側（クライアント）に登録する（例：claude mcp add ... のようなコマンドや設定画面で登録）。

  5. 認証を設定する（Bearerトークンやカスタムヘッダーをn8n側とAI側で一致させる）。

  6. AIから呼び出して動作を確認する（例：「このワークフロー実行して」とAIに指示）。

補足

  • ワークフローは「もしAが起きたらBをやる、次にCをやる」といった一連の作業の流れです。

  • MCP Server Triggerノードは「外から来た命令を受け取る入口」です。URLはその入口の住所だと考えてください。

  • 認証（Bearerトークン）は「合言葉」のようなもので、合言葉が合わないと入口は開きません。


5 Claude Codeでの具体的コマンド例と確認方法

  • 追加コマンド：

bash

claude mcp add --transport http notion https://mcp.example.com/mcp

  • 接続一覧：

bash

claude mcp list

  • 会話内での利用：接続後は通常の会話でツール操作が可能（例：「Notionのこのページを更新して」）。

運用ヒント：--scope local|project|user を使い、チーム共有は project を推奨（.mcp.json に保存）。

【補足】.mcp.json は接続設定を保存するファイル。チームで同じ設定を共有できます。

6 運用時の注意点（認証・ログ・スコープ）

  • 認証管理：トークンのローテーションと最小権限を設定。

  • ログ監視：呼び出しログとエラーログを定期確認。

  • データ保護：機密データはローカル（stdio）で扱う設計を優先。

  • 設定共有：.mcp.json をリポジトリで管理し差分を追う。

気づき：導入は簡単でも、運用設計（誰が何を使えるか）を最初に決めると後が楽。

【補足】ログは問題発生時の手がかりになります。定期的に確認しましょう。

7 中間まとめ（ここまでの気づき）

  • 導入手順は短く、効果は大きい：サーバー起動→認証→クライアント登録→動作確認の順で完了。

  • n8nと組み合わせると自律化が進む：AIが判断してワークフローを実行できる。

  • セキュリティと運用設計が鍵：認証・ログ・データ扱いを最初に決める。

8 最終まとめ（長め）

MCPは「AIと外部ツールをつなぐUSB‑C」のような存在で、一度接続を作れば複数AIで再利用できる点が最大の利点です。

主要ベンダーの採用により、学ぶ価値が高くなりました。導入は短時間で始められ、n8nのようなワークフローツールと組み合わせると「AIが自分で判断して必要なツールを使う」自律的な運用が可能になります。

運用では認証管理・ログ監視・機密データの扱いを優先し、.mcp.json をチームで共有すると再現性を確保。導入効果は開発工数削減と作業の高速化です。

9 文系向け用語解説（ふりがな付き）

  • MCP（エムシーピー）：Model Context Protocol。AIと外部サービスをつなぐ共通規格。

  • クライアント（くらいあんと）：ツールを使いたい側（例：Claude）。

  • サーバー（さーばー）：ツールを提供する側（例：Notion）。

  • Tools（つーるず）：AIが呼び出す機能（検索、作成など）。

  • Resources（りそーす）：AIが参照するデータ（ドキュメント等）。

  • Prompts（ぷろんぷと）：作業の指示テンプレート。

  • stdio（すたんだーどあいおー）：ローカル接続方式。自分のPC内で完結する。

  • HTTP / SSE（えいちてぃーてぃーぴー / えすえすいー）：リモート接続の通信方式。

  • Bearerトークン（べあーとーくん）：API認証で使う合言葉のような文字列。

  • n8n（エヌエイトエヌ）：ワークフロー自動化ツール。GUIで処理をつなげられる。

-----------------------------------------------------------------------------------------

#AI #人工知能 #MCP #ModelContextProtocol #AI連携 #自動化 #ワークフロー #n8n #Claude #ChatGPT #Gemini #OpenAI #Google #Microsoft #AWS #Anthropic #Notion #GitHub #Slack #API #プラグイン #JSONRPC #JSON #SDK #ダウンロード #導入 #設定 #チュートリアル #ハウツー #開発 #開発効率 #生産性 #自律化 #ワークフロー自動化 #ツール連携 #SSE #stdio #npx #Nodejs #ターミナル #認証 #Bearerトークン #セキュリティ #ログ監視 #CORS #デプロイ #クラウド #VPS #ローカル #mcpjson #スコープ #projectスコープ #localスコープ #userスコープ #テスト #動作確認 #Playwright #Figma #GitHubIssue #Webhook #n8nノード #MCPServerTrigger #MCPClient #導入手順 #チェックリスト #個人事業主 #フリーランス #エンタープライズ #Forrester #月間9700万 #成長 #インフラ #標準化 #共通規格 #USBC #Prompts #Tools #Resources #MCPサーバー #MCPクライアント

いいなと思ったら応援しよう！

kuyu May the Force be with you.