MCP使い方実践ガイド｜Claude Desktop/Code連携手順【2026年2月】

MCPとは何か（応用編）: 実装責務で分けると迷わない

MCPは「AIが外部ツールを使うための共通接続規格」です。運用では、構造理解より先に責務を明確にすると事故が減ります。誰が認証し、どこで権限を制御し、どこに監査ログを残すかを設計段階で固定します。

仕様バージョンも確認が必要です。MCPは日付ベースで更新され、2026年2月20日時点のVersioningページでは現行が2025-11-25です。`2024-11-05`は参照価値はあるものの、現行との差分確認が前提になります。

Claude Desktop・Claude CodeにMCPサーバーを接続する手順

実務で再現しやすい順序は、Desktopで設定形式を把握し、CodeでCLI管理に寄せる流れです。まずはローカルstdioサーバー1本で起動確認を取り、次にリモートMCPへ拡張します。

1. Claude Desktopの設定ファイルを確認する

2026年2月20日時点の公式Quickstartでは、macOSは~/Library/Application Support/Claude/claude_desktop_config.json、Windowsは%APPDATA%\\Claude\\claude_desktop_config.jsonを編集します。基本構造は次の `mcpServers` 形式です。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/workspace"
      ]
    }
  }
}

2. Claude CodeでMCPをCLI管理する

Anthropic公式ドキュメントでは、`claude mcp add` と `claude mcp add-json` が基本です。スコープは `local` / `project` / `user` で分けられます。

# 1) ローカルstdioサーバーを追加
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/you/workspace

# 2) JSON形式で追加
claude mcp add-json memory '{"type":"stdio","command":"npx","args":["-y","@modelcontextprotocol/server-memory"]}'

# 3) Claude Desktop設定を取り込む
claude mcp add-from-claude-desktop

操作体系を先に把握したい場合はClaude Code入門記事と併読すると、MCP以外の設定と競合しにくくなります。

公式MCPサーバー一覧と使い道: 参照実装とベンダー公式を分けて選ぶ

「公式MCPサーバー」は1種類ではありません。MCP Steering Groupが管理する参照実装と、Notion/GitHub/Slackなど各ベンダーが提供する公式リモートMCPを分けて評価するのが現実的です。

最初は参照実装（filesystem/fetch/memory）で運用設計を固め、その後に業務システム連携（Notion/GitHub/Slack）へ広げると、権限事故を抑えながら拡張できます。

Notion・GitHub・Slack連携を設定する（ステップバイステップ）

3サービスとも、事前権限の定義と接続後の参照範囲確認が成否を分けます。ここではClaude Codeコマンドで統一し、再現しやすい手順で整理します。

NOTION_TOKEN="secret_xxx" \
claude mcp add --transport http notion https://mcp.notion.com/mcp

GITHUB_PERSONAL_ACCESS_TOKEN="ghp_xxx" \
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

claude mcp add --transport http slack https://mcp.slack.com

接続後は「何が取得できるか」だけでなく「何が取得できてはいけないか」を同時に確認してください。評価観点を整理したい場合はコンテキスト設計の実践記事が役立ちます。

自作MCPサーバーの作り方（Node.js / Python最小例）

既存サーバーで要件が満たせない場合は、自作サーバーを最小構成で作って検証します。最初から複数ツールを詰め込まず、1ツールのみで起動確認する方がトラブル切り分けが速くなります。

Node.js最小例（stdio）

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";

const server = new Server(
  { name: "demo-mcp-server", version: "0.1.0" },
  { capabilities: { tools: {} } }
);

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: "echo_text",
      description: "受け取った文字列を返す",
      inputSchema: {
        type: "object",
        properties: { text: { type: "string" } },
        required: ["text"],
      },
    },
  ],
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name !== "echo_text") {
    throw new Error("Unknown tool");
  }
  const text = String(request.params.arguments?.text ?? "");
  return { content: [{ type: "text", text: `echo: ${text}` }] };
});

const transport = new StdioServerTransport();
await server.connect(transport);

Python最小例（stdio）

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("demo-python-server")

@mcp.tool()
def summarize_title(text: str) -> str:
    cleaned = " ".join(text.split())
    return f"[summary] {cleaned[:80]}"

if __name__ == "__main__":
    mcp.run(transport="stdio")

拡張順序は「入力バリデーション」「タイムアウト」「監査ログ」「承認フロー」です。AIエージェント全体の設計と合わせて考える場合はAIエージェント構築ガイドを参照してください。

よくあるエラーとトラブルシューティング

MCPの障害は「接続」「認証」「権限」「実行時間」の4系統に分かれます。障害対応を早くするには、最初にどの系統かを切り分けることが重要です。

API連携の失敗切り分けをさらに深掘りする場合はAPI実装ガイドの「障害時ログ設計」の章も参考になります。

FAQ

Q. Claude DesktopのMCP設定ファイルはどこにありますか？

A. 2026年2月20日時点で、macOSは~/Library/Application Support/Claude/claude_desktop_config.json、Windowsは%APPDATA%\\Claude\\claude_desktop_config.jsonです。JSON内のmcpServersにサーバー定義を追加します。

Q. Claude CodeとClaude DesktopはどちらでMCPを使うべきですか？

A. コード編集やCLI自動化が中心ならClaude Code、会話中心で軽く試すならClaude Desktopが向いています。多くのチームはDesktopで検証し、運用をCodeへ移す構成で始めます。

Q. MCP仕様の2024-11-05版は今も使えますか？

A. 参照は可能ですが、2026年2月20日時点のVersioningページでは現行は2025-11-25です。新規実装は最新仕様を基準にし、旧版との差分確認が必要です。

Q. Notion/GitHub/Slack連携で最初に確認すべき点は何ですか？

A. OAuthやAPIトークンの権限範囲を最小化し、読み取り中心で開始することです。特に書き込み系は承認フローと監査ログの設定を先に決める必要があります。

Q. 自作MCPサーバーはNode.jsとPythonのどちらが始めやすいですか？

A. 既存チームの実行環境に合わせるのが最適です。JavaScript資産が多いならNode.js、データ処理基盤がPython中心ならPythonが実装と運用の負担を下げられます。

Q. MCP接続でspawn ENOENTやserver not foundが出る原因は？

A. 実行コマンドのパス違い、依存パッケージ未インストール、設定ファイルのJSON構文不正が主因です。コマンド単体実行で起動確認した後、設定ファイルを再検証してください。