前提条件
- Claude Desktop / Cursor / VS Code がインストール済み
- 導入するサーバーが必要とするランタイム（多くはNode.jsまたはPython。追加依存が要るものもあり）
- API認証情報を手元に（例：GitHubトークン）——設定中に使います
Claude Desktop
GUIでの手順：
- Claude Desktopを開く → Settings
- Developer へ移動 → Edit Config をクリック
claude_desktop_config.jsonのmcpServersセクションにサーバーを追加：
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "あなたのトークン" }
}
}
}
ファイルを保存し、Claude Desktopを再起動。新しいツールが左サイドバーのツールリストに現れます。コマンドと引数は必ずサーバーのREADMEを参照してください。
Cursor
- コマンドパレットを開く（
Ctrl+Shift+P/Cmd+Shift+P） - Cursor Settings > MCP を検索して選択
- Add New MCP Server をクリックし、トランスポート種別（stdio または SSE）を選び、コマンド / 引数を入力
VS Code
- 拡張機能 MCP Client をインストール（またはMCP対応内蔵のCopilot / 拡張機能を利用）
- 拡張機能の設定で
mcpServersを、Claude Desktopと同じJSON形式で構成 - VS Codeのウィンドウを再読み込みして変更を反映
画面はクライアントのバージョンにより変わることがあります——正確な手順は必ず公式ドキュメントを確認。コマンド / JSONの構造は常にサーバーのREADMEに従います。
よくあるエラーの解消
| エラー | 原因 | 解決 |
|---|---|---|
| command not found | Node / Pythonランタイムが未導入か、PATHにない | ランタイムを入れてクライアントを再起動 |
| 401 / 403 | API認証情報が無効または期限切れ | トークンを再発行し、環境設定を再確認 |
| Connection refused | SSEサーバーのアドレス誤り、またはサービスが動いていない | URL + ポートを確認し、サーバーが起動しているか確認 |
| Tool not found | クライアント未再起動のため設定変更が反映されていない | 設定保存後にクライアントを完全に再起動 |
安全上の注意
- トークンはローカルの設定ファイルだけに——ファイルをGitに絶対プッシュしない（
.gitignoreを忘れずに） - 信頼でき、スター数の多いプロジェクトのサーバーだけ入れる——未検証サーバーはデータを持ち出す恐れがあります
- 高権限サーバーは必要な場合にだけ導入する