{"title":"MCP у Claude Code","slug":"claude-code","category":"mcp","summary":"Використовуйте інструменти Synapse з термінальним агентом Claude Code — постійна пам'ять для сесій програмування.","audience":["human","llm"],"tags":["mcp","claude-code","terminal","coding"],"difficulty":"intermediate","updated":"2026-06-27","word_count":214,"read_minutes":1,"llm_context":"Claude Code config: ~/.claude/config.json (or via `claude mcp add` command)\nCommand: npx -y synapse-mcp-api@latest\nEnv: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional)\nAlternative: `claude mcp add synapse -- npx -y synapse-mcp-api@latest`\nThen: set SYNAPSE_MIND_KEY env var in your shell\nTest: in claude code, type \"recall all my memories\"\n","lang":"uk","translated":true,"requested_lang":"uk","content_markdown":"\n# MCP у Claude Code\n\nClaude Code — це термінальний агент програмування від Anthropic. Із Synapse MCP\nClaude Code отримує постійну пам'ять між сесіями програмування — він пам'ятає\nконтекст вашого проєкту, минулі рішення та шаблони кодової бази.\n\n## Налаштування\n\n### Метод 1: CLI-команда (рекомендовано)\n\n```bash\n# Add Synapse as an MCP server\nclaude mcp add synapse -- npx -y synapse-mcp-api@latest\n\n# Set your Mind Key as env var (add to ~/.bashrc or ~/.zshrc)\nexport SYNAPSE_MIND_KEY=\"mk_YOUR_MIND_KEY_HERE\"\nexport SYNAPSE_URL=\"https://synapse.schaefer.zone\"  # optional, defaults to synapse.schaefer.zone\n```\n\n### Метод 2: редагування конфігураційного файлу\n\nВідредагуйте `~/.claude/config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"synapse\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n      \"env\": {\n        \"SYNAPSE_MIND_KEY\": \"mk_YOUR_MIND_KEY_HERE\",\n        \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n      }\n    }\n  }\n}\n```\n\n## Перевірка роботи\n\nЗапустіть Claude Code:\n\n```bash\nclaude\n```\n\nУ промпті Claude Code введіть:\n\n```\nrecall all my memories\n```\n\nClaude має викликати `memory_recall` і відповісти вашими збереженими спогадами.\n\n## Типові шаблони\n\n### Постійність контексту проєкту\n\nНа початку сесії програмування:\n\n```\nrecalling my memories — what projects am I working on?\n```\n\nClaude викликає `memory_recall`, бачить ваш список проєктів і продовжує роботу\nз того місця, де ви зупинилися.\n\n### Рішення щодо кодової бази\n\nКоли ви приймаєте архітектурне рішення:\n\n```\nstore this: \"We chose PostgreSQL over SQLite because of concurrent write\nperformance. Decision made on 2026-06-27.\"\n```\n\nClaude викликає `memory_store` із категорією `project` та пріоритетом `high`.\n\n### Уникнення минулих помилок\n\n```\nwhat mistakes have I made with this codebase?\n```\n\nClaude шукає спогади з категорією `mistake` та нагадує вам про минулі помилки.\n\n### Відстеження завдань\n\n```\ncreate a task: \"Refactor auth module to use JWT refresh tokens\"\n```\n\nClaude викликає `task_create`, і завдання зберігається між сесіями.\n\n## Профілі інструментів\n\nДля сесій програмування, коли вам не потрібні всі 119 інструментів:\n\n```bash\n# Set profile via env var\nexport MCP_PROFILE=\"standard\"  # 25 tools, ~2500 tokens\n\n# Or in config.json\n\"env\": {\n  \"SYNAPSE_MIND_KEY\": \"mk_...\",\n  \"MCP_PROFILE\": \"standard\"\n}\n```\n\n## Вирішення проблем\n\n### MCP-сервер не запускається\n\n```bash\n# Test the MCP server manually\nnpx -y synapse-mcp-api@latest\n\n# Should print:\n# [info] synapse-mcp Streamable HTTP server ready\n# [info]   MCP:      http://localhost:13100/mcp\n```\n\n### Mind Key не розпізнається\n\n```bash\n# Verify env var is set\necho $SYNAPSE_MIND_KEY\n\n# Test directly\ncurl -H \"Authorization: Bearer $SYNAPSE_MIND_KEY\" \\\n     https://synapse.schaefer.zone/memory/recall\n```\n\n### Claude Code не бачить інструментів\n\n- Перезапустіть Claude Code після змін конфігурації\n- Перевірте `claude mcp list`, щоб упевнитися, що Synapse зареєстрований\n- Див. [Вирішення проблем MCP](/docs/mcp/troubleshooting)\n\n## Наступні кроки\n\n- [Налаштування Claude Desktop](/docs/mcp/claude-desktop)\n- [Налаштування Cursor](/docs/mcp/cursor)\n- [Посібник зі створення постійного LLM-агента](/docs/guides/persistent-llm-agent)\n","content_html":"<h1>MCP у Claude Code</h1>\n<p>Claude Code — це термінальний агент програмування від Anthropic. Із Synapse MCP\nClaude Code отримує постійну пам&#39;ять між сесіями програмування — він пам&#39;ятає\nконтекст вашого проєкту, минулі рішення та шаблони кодової бази.</p>\n<h2>Налаштування</h2>\n<h3>Метод 1: CLI-команда (рекомендовано)</h3>\n<pre><code class=\"hljs language-bash\"><span class=\"hljs-comment\"># Add Synapse as an MCP server</span>\nclaude mcp add synapse -- npx -y synapse-mcp-api@latest\n\n<span class=\"hljs-comment\"># Set your Mind Key as env var (add to ~/.bashrc or ~/.zshrc)</span>\n<span class=\"hljs-built_in\">export</span> SYNAPSE_MIND_KEY=<span class=\"hljs-string\">&quot;mk_YOUR_MIND_KEY_HERE&quot;</span>\n<span class=\"hljs-built_in\">export</span> SYNAPSE_URL=<span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span>  <span class=\"hljs-comment\"># optional, defaults to synapse.schaefer.zone</span></code></pre><h3>Метод 2: редагування конфігураційного файлу</h3>\n<p>Відредагуйте <code>~/.claude/config.json</code>:</p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;mcpServers&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n    <span class=\"hljs-attr\">&quot;synapse&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n      <span class=\"hljs-attr\">&quot;command&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;npx&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;args&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-string\">&quot;-y&quot;</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-string\">&quot;synapse-mcp-api@latest&quot;</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;env&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_MIND_KEY&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mk_YOUR_MIND_KEY_HERE&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_URL&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span>\n      <span class=\"hljs-punctuation\">}</span>\n    <span class=\"hljs-punctuation\">}</span>\n  <span class=\"hljs-punctuation\">}</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><h2>Перевірка роботи</h2>\n<p>Запустіть Claude Code:</p>\n<pre><code class=\"hljs language-bash\">claude</code></pre><p>У промпті Claude Code введіть:</p>\n<pre><code class=\"hljs language-plaintext\">recall all my memories</code></pre><p>Claude має викликати <code>memory_recall</code> і відповісти вашими збереженими спогадами.</p>\n<h2>Типові шаблони</h2>\n<h3>Постійність контексту проєкту</h3>\n<p>На початку сесії програмування:</p>\n<pre><code class=\"hljs language-plaintext\">recalling my memories — what projects am I working on?</code></pre><p>Claude викликає <code>memory_recall</code>, бачить ваш список проєктів і продовжує роботу\nз того місця, де ви зупинилися.</p>\n<h3>Рішення щодо кодової бази</h3>\n<p>Коли ви приймаєте архітектурне рішення:</p>\n<pre><code class=\"hljs language-plaintext\">store this: &quot;We chose PostgreSQL over SQLite because of concurrent write\nperformance. Decision made on 2026-06-27.&quot;</code></pre><p>Claude викликає <code>memory_store</code> із категорією <code>project</code> та пріоритетом <code>high</code>.</p>\n<h3>Уникнення минулих помилок</h3>\n<pre><code class=\"hljs language-plaintext\">what mistakes have I made with this codebase?</code></pre><p>Claude шукає спогади з категорією <code>mistake</code> та нагадує вам про минулі помилки.</p>\n<h3>Відстеження завдань</h3>\n<pre><code class=\"hljs language-plaintext\">create a task: &quot;Refactor auth module to use JWT refresh tokens&quot;</code></pre><p>Claude викликає <code>task_create</code>, і завдання зберігається між сесіями.</p>\n<h2>Профілі інструментів</h2>\n<p>Для сесій програмування, коли вам не потрібні всі 119 інструментів:</p>\n<pre><code class=\"hljs language-bash\"><span class=\"hljs-comment\"># Set profile via env var</span>\n<span class=\"hljs-built_in\">export</span> MCP_PROFILE=<span class=\"hljs-string\">&quot;standard&quot;</span>  <span class=\"hljs-comment\"># 25 tools, ~2500 tokens</span>\n\n<span class=\"hljs-comment\"># Or in config.json</span>\n<span class=\"hljs-string\">&quot;env&quot;</span>: {\n  <span class=\"hljs-string\">&quot;SYNAPSE_MIND_KEY&quot;</span>: <span class=\"hljs-string\">&quot;mk_...&quot;</span>,\n  <span class=\"hljs-string\">&quot;MCP_PROFILE&quot;</span>: <span class=\"hljs-string\">&quot;standard&quot;</span>\n}</code></pre><h2>Вирішення проблем</h2>\n<h3>MCP-сервер не запускається</h3>\n<pre><code class=\"hljs language-bash\"><span class=\"hljs-comment\"># Test the MCP server manually</span>\nnpx -y synapse-mcp-api@latest\n\n<span class=\"hljs-comment\"># Should print:</span>\n<span class=\"hljs-comment\"># [info] synapse-mcp Streamable HTTP server ready</span>\n<span class=\"hljs-comment\"># [info]   MCP:      http://localhost:13100/mcp</span></code></pre><h3>Mind Key не розпізнається</h3>\n<pre><code class=\"hljs language-bash\"><span class=\"hljs-comment\"># Verify env var is set</span>\n<span class=\"hljs-built_in\">echo</span> <span class=\"hljs-variable\">$SYNAPSE_MIND_KEY</span>\n\n<span class=\"hljs-comment\"># Test directly</span>\ncurl -H <span class=\"hljs-string\">&quot;Authorization: Bearer <span class=\"hljs-variable\">$SYNAPSE_MIND_KEY</span>&quot;</span> \\\n     https://synapse.schaefer.zone/memory/recall</code></pre><h3>Claude Code не бачить інструментів</h3>\n<ul>\n<li>Перезапустіть Claude Code після змін конфігурації</li>\n<li>Перевірте <code>claude mcp list</code>, щоб упевнитися, що Synapse зареєстрований</li>\n<li>Див. <a href=\"/docs/mcp/troubleshooting\">Вирішення проблем MCP</a></li>\n</ul>\n<h2>Наступні кроки</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Налаштування Claude Desktop</a></li>\n<li><a href=\"/docs/mcp/cursor\">Налаштування Cursor</a></li>\n<li><a href=\"/docs/guides/persistent-llm-agent\">Посібник зі створення постійного LLM-агента</a></li>\n</ul>\n","urls":{"html":"/docs/mcp/claude-code","text":"/docs/mcp/claude-code?format=text","json":"/docs/mcp/claude-code?format=json","llm":"/docs/mcp/claude-code?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}