{"title":"MCP FAQ","slug":"mcp-faq","category":"faq","summary":"MCP 통합에 대한 일반적인 질문 — 도구, 전송, 문제 해결.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":398,"read_minutes":2,"lang":"ko","translated":true,"requested_lang":"ko","content_markdown":"\n# MCP FAQ\n\nSynapse MCP 서버에 대한 일반적인 질문입니다.\n\n## MCP란 무엇입니까?\n\nMCP (Model Context Protocol)는 LLM-도구 통합을 위한 Anthropic의 개방\n표준입니다. API 문서를 프롬프트에 붙여넣는 대신, MCP 서버에 도구를\n등록하고 LLM이 네이티브 함수로 호출합니다.\n\n[MCP란 무엇입니까?](/docs/mcp/what-is-mcp)를 참조하십시오.\n\n## Synapse MCP는 몇 개의 도구를 노출합니까?\n\n12개 카테고리에 걸쳐 **79개 도구**: memory, chat, scheduler, tasks,\nscripts, computers, push, user, utility, visualization, sharing, webhooks,\nbrowser.\n\n전체 목록은 [MCP란 무엇입니까?](/docs/mcp/what-is-mcp)를 참조하십시오.\n\n## 어떤 MCP 클라이언트가 지원됩니까?\n\n- Claude Desktop (macOS, Windows)\n- Claude Code (터미널)\n- Cursor (IDE)\n- Continue.dev (VS Code, JetBrains)\n- Cline (VS Code)\n- MCP 호환 클라이언트\n\n구성 예시는 [Claude Desktop 설정](/docs/mcp/claude-desktop)을 참조하십시오.\n\n## 어떤 전송이 지원됩니까?\n\n1. **stdio** (로컬, 데스크톱에 권장)\n2. **HTTP/SSE** (원격, 다중 테넌트)\n3. **WebSocket** (모바일, 대용량)\n\n## Claude Desktop은 어떻게 구성합니까?\n\n`claude_desktop_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_KEY\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n[Claude Desktop 설정](/docs/mcp/claude-desktop)을 참조하십시오.\n\n## Claude Desktop에 도구가 나타나지 않는 이유는 무엇입니까?\n\n1. **Claude Desktop을 완전히 재시작** (macOS에서 Cmd+Q)\n2. **구성 파일이 유효한 JSON인지 확인**\n3. **Node.js 18+ 설치 확인**\n4. **MCP 로그 확인**: `~/Library/Logs/Claude/mcp.log`\n\n[MCP 문제 해결](/docs/mcp/troubleshooting)을 참조하십시오.\n\n## 다른 마인드를 사용하려면 어떻게 합니까?\n\nMCP 구성에서 `SYNAPSE_MIND_KEY`를 변경하고 클라이언트를 재시작하십시오.\n\n여러 마인드의 경우, 다른 Mind Key로 여러 MCP 서버 인스턴스를\n실행하십시오.\n\n## 노출되는 도구를 제한할 수 있습니까?\n\n네, **도구 프로필**을 사용하십시오:\n\n- `minimal`: 8개 복합 도구 (~500 토큰)\n- `standard`: 25개 도구 (~2,500 토큰)\n- `full`: 119개 도구 (~8,250 토큰, 기본값)\n\n`MCP_PROFILE` 환경 변수 또는 `Mcp-Tool-Profile` 헤더로 설정.\n\n## MCP 문제는 어떻게 디버그합니까?\n\n1. **MCP 서버 수동 실행**: `npx -y synapse-mcp-api@latest`\n2. **클라이언트 로그 확인** (클라이언트별로 다름)\n3. **Mind Key 작동 확인**: `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Synapse 상태 확인**: `curl https://synapse.schaefer.zone/health`\n\n[MCP 문제 해결](/docs/mcp/troubleshooting)을 참조하십시오.\n\n## MCP 서버는 무료입니까?\n\n네. npm 패키지 `synapse-mcp-api`는 오픈 소스입니다. `synapse-mcp.schaefer.zone`의\n호스팅된 MCP 서버는 공용 사용이 무료입니다.\n\n## MCP 서버를 자체 호스팅할 수 있습니까?\n\n네:\n\n```bash\nnpm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api\n```\n\n## MCP는 직접 API 호출과 어떻게 다릅니까?\n\n| 측면 | 직접 API | MCP |\n|--------|-----------|-----|\n| LLM이 알아야 할 것 | URL, 헤더, 인증 | 도구 이름만 |\n| 인증 처리 | 수동 | 자동 (환경 변수) |\n| 도구 검색 | /endpoints 읽기 | MCP 프로토콜을 통해 자동 |\n| 오류 처리 | 수동 | 표준화 |\n| 적합한 용도 | 커스텀 통합 | LLM 에이전트 |\n\n## 자체 MCP 클라이언트를 구축할 수 있습니까?\n\n네. 공식 MCP SDK를 사용하십시오:\n\n- TypeScript: `@modelcontextprotocol/sdk`\n- Python: `mcp`\n\n[커스텀 MCP 클라이언트](/docs/mcp/custom-client)를 참조하십시오.\n\n## MCP 버그는 어떻게 보고합니까?\n\n이슈를 열으십시오: \n\n포함 사항:\n\n- MCP 서버 버전\n- 클라이언트 이름 및 버전\n- 운영 체제\n- 관련 로그\n- 재현 단계\n\n## 다음 단계\n\n- [MCP란 무엇입니까?](/docs/mcp/what-is-mcp)\n- [Claude Desktop 설정](/docs/mcp/claude-desktop)\n- [MCP 문제 해결](/docs/mcp/troubleshooting)\n","content_html":"

MCP FAQ

\n

Synapse MCP 서버에 대한 일반적인 질문입니다.

\n

MCP란 무엇입니까?

\n

MCP (Model Context Protocol)는 LLM-도구 통합을 위한 Anthropic의 개방\n표준입니다. API 문서를 프롬프트에 붙여넣는 대신, MCP 서버에 도구를\n등록하고 LLM이 네이티브 함수로 호출합니다.

\n

MCP란 무엇입니까?를 참조하십시오.

\n

Synapse MCP는 몇 개의 도구를 노출합니까?

\n

12개 카테고리에 걸쳐 79개 도구: memory, chat, scheduler, tasks,\nscripts, computers, push, user, utility, visualization, sharing, webhooks,\nbrowser.

\n

전체 목록은 MCP란 무엇입니까?를 참조하십시오.

\n

어떤 MCP 클라이언트가 지원됩니까?

\n\n

구성 예시는 Claude Desktop 설정을 참조하십시오.

\n

어떤 전송이 지원됩니까?

\n
    \n
  1. stdio (로컬, 데스크톱에 권장)
    2. \n
  2. HTTP/SSE (원격, 다중 테넌트)
    3. \n
  3. WebSocket (모바일, 대용량)
    4. \n
\n

Claude Desktop은 어떻게 구성합니까?

\n

claude_desktop_config.json을 편집하십시오:

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_KEY",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}

Claude Desktop 설정을 참조하십시오.

\n

Claude Desktop에 도구가 나타나지 않는 이유는 무엇입니까?

\n
    \n
  1. Claude Desktop을 완전히 재시작 (macOS에서 Cmd+Q)
    2. \n
  2. 구성 파일이 유효한 JSON인지 확인
    3. \n
  3. Node.js 18+ 설치 확인
    4. \n
  4. MCP 로그 확인: ~/Library/Logs/Claude/mcp.log
    5. \n
\n

MCP 문제 해결을 참조하십시오.

\n

다른 마인드를 사용하려면 어떻게 합니까?

\n

MCP 구성에서 SYNAPSE_MIND_KEY를 변경하고 클라이언트를 재시작하십시오.

\n

여러 마인드의 경우, 다른 Mind Key로 여러 MCP 서버 인스턴스를\n실행하십시오.

\n

노출되는 도구를 제한할 수 있습니까?

\n

네, 도구 프로필을 사용하십시오:

\n\n

MCP_PROFILE 환경 변수 또는 Mcp-Tool-Profile 헤더로 설정.

\n

MCP 문제는 어떻게 디버그합니까?

\n
    \n
  1. MCP 서버 수동 실행: npx -y synapse-mcp-api@latest
    2. \n
  2. 클라이언트 로그 확인 (클라이언트별로 다름)
    3. \n
  3. Mind Key 작동 확인: curl -H "Authorization: Bearer mk_..." .../memory/recall
    4. \n
  4. Synapse 상태 확인: curl https://synapse.schaefer.zone/health
    5. \n
\n

MCP 문제 해결을 참조하십시오.

\n

MCP 서버는 무료입니까?

\n

네. npm 패키지 synapse-mcp-api는 오픈 소스입니다. synapse-mcp.schaefer.zone의\n호스팅된 MCP 서버는 공용 사용이 무료입니다.

\n

MCP 서버를 자체 호스팅할 수 있습니까?

\n

네:

\n
npm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api

MCP는 직접 API 호출과 어떻게 다릅니까?

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
측면직접 APIMCP
LLM이 알아야 할 것URL, 헤더, 인증도구 이름만
인증 처리수동자동 (환경 변수)
도구 검색/endpoints 읽기MCP 프로토콜을 통해 자동
오류 처리수동표준화
적합한 용도커스텀 통합LLM 에이전트
\n

자체 MCP 클라이언트를 구축할 수 있습니까?

\n

네. 공식 MCP SDK를 사용하십시오:

\n\n

커스텀 MCP 클라이언트를 참조하십시오.

\n

MCP 버그는 어떻게 보고합니까?

\n

이슈를 열으십시오: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

\n

포함 사항:

\n\n

다음 단계

\n\n","urls":{"html":"/docs/faq/mcp-faq","text":"/docs/faq/mcp-faq?format=text","json":"/docs/faq/mcp-faq?format=json","llm":"/docs/faq/mcp-faq?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}