MCPサーバーの作り方とは、AI に使わせたい操作を道具として書き、Claude Code につないで動かす手順です。
- 作る: 公式の SDK で道具を書き、標準出力に何も書かないようにする
- つなぐ:
claude mcp addで登録し、/mcpでつながったかを見る - 配る: 中身を直したら版を上げる。走っている会話は新しい口を読み直さない
MCP そのものの意味と API との違いは MCP と API の違い、出来合いの MCP を探すなら MCP サーバーの一覧 へ。口を使う側の AIエージェント の説明は柱の記事にあります。
作る手順
| 手 | やること | 落とし穴 |
|---|---|---|
| 作る | 公式の SDK（Python・TypeScript ほか）で、道具の名前・説明・入力を書く | 手元とつなぐ形（stdio）では標準出力に書かない。ログは標準エラーへ（出典 1） |
| つなぐ | claude mcp add <名前> -- <起動の命令> で Claude Code に登録する | -- より後ろはそのままサーバーに渡る。範囲は既定で「この人のこの作業場だけ」（出典 2） |
| 確かめる | Claude Code の中で /mcp、外から claude mcp list | 「つながった」と出ても、走っている会話に道具が見えるとは限らない（下の 2） |
| 配る | ほかの人・ほかの機体でも使えるようにする | 中身だけ直して版を上げないと届かない（下の 1） |
公式の手引きの注意で一番効くのは「stdio のサーバーでは標準出力に書かない」です。print() や console.log() の 1 行で、AI とのやり取りの文が壊れます（出典 1）。
作って配って詰まった 4 か所
ブルーランプは、自社の AI 社員（決まった仕事を受け持つ AI エージェント）が使う MCP を自社で作り、会員にも配っています。作るところより、配った後で止まりました。
| 起きたこと | 直し方 | 記録 | |
|---|---|---|---|
| 1 版 | 中身を直したのに版の番号を上げずに配ったら、各機体が「手元とカタログは同じ」と読み、直しが届かなかった | 中身を変えたら版を必ず上げる。配るだけでは機体に入らず、各機体で入れ直しが要る | 社の実測 2026-10-05 |
| 2 読み直し | 新しい MCP を入れて「入った」と返ったのに、走っている会話の道具の一覧に 1 つも出なかった | 走っている会話は道具の一覧を読み直さない。/mcp でつなぎ直すか、新しい会話で始める | 社の実測 2026-09-19 |
| 3 入れ忘れ | 機体を移したら、ある MCP がその機体に入っておらず、呼んだ席が起動で落ちた（MODULE_NOT_FOUND） | 機体を移すときの点検表に「どの MCP が入っているか」を足し、入れてから席を起こす | 社の実測 2026-09-26 |
| 4 再起動 | ほかの会話の MCP を、こちらの会話から起こし直そうとして、できなかった | MCP は会話ごとの子として動く。起こし直せるのは自分の会話の分だけ。ほかは、その会話が次に起きたときに新しい版を拾う | 社の実測 2026-09-24 |
4 つとも、MCP の中身のせいではありませんでした。「作った物」と「その会話が今つかんでいる物」は別、と覚えておくと、ほとんどの「入れたのに動かない」は説明がつきます。
作る前に決めておくこと
- 道具の説明は AI が読む文: AI は説明を読んでどの道具を使うか選びます。人向けの略語より、何をして何を返すかを 1 文で
- 秘密の値を道具の返事に出さない: 合言葉や鍵は環境の値で渡し、返事・ログに出さない
- 出来合いを先に探す: 同じ操作の MCP が配られていれば作らずに済みます（MCP サーバーの一覧）
よくある質問
MCP サーバーを作るのにプログラミングは要りますか？
道具を書くところはプログラムです。ただ、作る作業そのものを AI エージェントに任せることはできます。人が決めるのは「どの操作を口にするか」です。
作った MCP が Claude Code に出てきません
まず /mcp でつながっているかを見て、つながっているのに道具が見えなければ、新しい会話で始め直します（上の 2）。つながっていなければ、標準出力に何か書いていないかを疑います（出典 1）。
直したのにほかの人の手元で古いまま動きます
版を上げたか、相手の機体で入れ直したかを確かめます（上の 1）。
出典
- Model Context Protocol「Build an MCP server」https://modelcontextprotocol.io/docs/develop/build-server（2026-10-17 に確かめた）
- Claude Code ドキュメント「Connect Claude Code to tools via MCP」https://code.claude.com/docs/en/mcp（2026-10-17 に確かめた）
- 社の実測: ブルーランプの運営が自社の AI 社員の記録に残した、MCP を作って配ったときの躓き（2026-09-19・09-24・09-26・10-05）
書いた人: ブルーランプ編集部 ／ 公開 2026-10-17 ／ 更新 2026-10-17