Cursor での MCP
Synapse を Cursor IDE に接続してコーディングセッションをまたぐ永続的プロジェクトメモリを実現。
Cursor での MCP
Cursor は VS Code ベースの AI 駆動 IDE です。Synapse MCP により、Cursor はセッションをまたぐ永続的メモリを得ます — プロジェクトの決定、コードベースのパターン、過去のデバッグセッションを記憶します。
前提条件
- Cursor IDE がインストール済み（https://cursor.com）
- Node.js 18+
- Synapse Mind Key
セットアップ
ステップ 1：Cursor 設定を開く
Cursor で：
- 設定を開く（macOS では Cmd+,、Windows/Linux では Ctrl+,）
- 「MCP」を検索するか、
Cursor Settings → MCP Serversに移動
ステップ 2：Synapse MCP サーバーを追加
「Add MCP Server」をクリックして設定します：
| フィールド | 値 |
|---|---|
| 名前 | synapse |
| タイプ | stdio |
| コマンド | npx -y synapse-mcp-api@latest |
| 環境変数 | SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone |
ステップ 3：config.json を直接編集（代替）
Cursor は MCP 設定を ~/.cursor/config.json に保存します：
{
"mcpServers": {
"synapse": {
"command": "npx",
"args": ["-y", "synapse-mcp-api@latest"],
"env": {
"SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",
"SYNAPSE_URL": "https://synapse.schaefer.zone"
}
}
}
}ステップ 4：Cursor を再起動
Cursor を完全に再起動します（macOS では Cmd+Q して再度開く）。
動作確認
Cursor のチャットパネル（Cmd+L）で：
recall all my memoriesCursor は memory_recall を呼び出し、保存されたメモリで応答するはずです。
よくあるパターン
プロジェクトのオンボーディング
新しいプロジェクトを開くとき：
recalling project context — what do I know about this codebase?Cursor は memory_recall を呼び出し、前回中断した箇所から作業を続けます。
アーキテクチャの決定
store this decision: "Using Fastify instead of Express for this project
because of schema validation. Date: 2026-06-27."Cursor は high 優先度の project メモリとして保存します。
デバッグ履歴
what bugs have I hit in this codebase?Cursor は mistake メモリを検索し、過去の修正を思い出させます。
セッションをまたぐコードパターン
search memories: "authentication pattern"Cursor は以前行った認証実装に関するメモリを見つけます。
トラブルシューティング
MCP サーバーが接続しない
- Node.js を確認：
node --version（≥ 18） - MCP サーバーをテスト：
npx -y synapse-mcp-api@latest（エラーなしで起動するはず） - Cursor の MCP ログを確認（View → Output → MCP）
- Cursor を完全に再起動
ツールが表示されない
~/.cursor/config.jsonが有効な JSON か確認SYNAPSE_MIND_KEY環境変数が設定されているか確認- Cursor が MCP をサポートするバージョンか確認（≥ 0.42）
Mind Key が無効
# Test your Mind Key directly
curl -H "Authorization: Bearer mk_YOUR_KEY" \
https://synapse.schaefer.zone/memory/recall