登録するとは何をすることか

stdio のサーバーの登録は、要するに「このコマンドを起動してください」と伝えるだけです。特別な仕組みはありません。

{
	"command": "node",
	"args": ["docs/samples/03-sdk/server.mjs"]
}

ホストはこれを子プロセスとして起こし、標準入出力で話しかけます。どのホストでも中身は同じで、書き方と置き場所だけが違います。

置き場所には範囲がある

Claude Code

コマンドで登録する

# プロジェクト範囲（.mcp.json に書かれる）
claude mcp add --scope project memo -- node docs/samples/06-memo/server.mjs

# 環境変数を渡す
claude mcp add memo -e MEMO_FILE=C:/data/memo.jsonl -- node server.mjs

# HTTP のサーバー
claude mcp add --transport http remote https://example.com/mcp

-- より後ろが、そのまま起動するコマンドになります。この区切りを忘れると、後ろの引数が claude のものとして読まれます。

ファイルに直接書く

プロジェクト範囲の実体は、リポジトリ直下の .mcp.json です。手で書いても同じです。

{
	"mcpServers": {
		"memo": {
			"command": "node",
			"args": ["docs/samples/06-memo/server.mjs"]
		}
	}
}

確かめる

claude mcp list        # 一覧と接続の可否
claude mcp get memo    # 1 本の詳細
claude mcp remove memo # 消す

Codex

コマンドで登録する

codex mcp add memo -- node docs/samples/06-memo/server.mjs

# HTTP のサーバー
codex mcp add remote --url https://example.com/mcp

# 環境変数
codex mcp add memo --env MEMO_FILE=C:/data/memo.jsonl -- node server.mjs

書かれる先は ~/.codex/config.toml です。Claude Code と違い、プロジェクト単位の設定ファイルはありません。

設定を書き換えずに試す

-c でその場だけ上書きできます。設定ファイルを汚さずに試せるので、動作確認に向きます。

codex exec -c 'mcp_servers.memo={command="node", args=["docs/samples/06-memo/server.mjs"]}' "メモを検索して"

確かめる

codex mcp list
codex mcp get memo
codex mcp remove memo

Antigravity

Antigravity は VS Code をもとにしたエディタなので、登録の作法もそちら寄りです。

antigravity --add-mcp '{"name":"memo","command":"node","args":["docs/samples/06-memo/server.mjs"]}'

JSON を 1 つの引数として渡します。PowerShell では全体をシングルクォートで囲みます。ダブルクォートで囲むと、中の " が壊れます。

3 つの違いのまとめ

動かないときの切り分け

「登録したのにツールが出てこない」。このとき最初にやるべきは、どこまで届いているかを見ることです。

観測用のサーバーを挟む

受け取った行をすべてファイルに書き出すサーバーを用意しておくと、一発で分かります。samples/02-minimal/probe.mjs がそれです。

function record(direction, text) {
	const stamp = new Date().toISOString();
	appendFileSync(LOG, `${stamp} ${direction} ${text}\n`, 'utf8');
}

これを登録して呼ぶと、こう残ります。

2026-09-07T09:43:33.182Z *** 起動 pid=22140
2026-09-07T09:43:33.335Z --> {"method":"initialize","params":{"protocolVersion":"2025-11-25",...}}
2026-09-07T09:43:33.337Z <-- {"jsonrpc":"2.0","id":0,"result":{...}}
2026-09-07T09:43:33.471Z --> {"jsonrpc":"2.0","method":"notifications/initialized"}
2026-09-07T09:43:33.546Z --> {"method":"tools/list","jsonrpc":"2.0","id":1}
2026-09-07T09:43:41.732Z --> {"method":"tools/call","params":{"name":"add",...}}

よくある原因

次の章へ

登録して呼べるようになりました。次は Tools 以外の 2 つ、Resources と Prompts を扱います。