MCP FAQ

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

MCP란 무엇입니까?

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

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

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

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

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

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

• Claude Desktop (macOS, Windows)
• Claude Code (터미널)
• Cursor (IDE)
• Continue.dev (VS Code, JetBrains)
• Cline (VS Code)
• MCP 호환 클라이언트

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

어떤 전송이 지원됩니까?

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

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

claude_desktop_config.json을 편집하십시오:

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

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

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

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

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

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

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

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

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

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

• minimal: 8개 복합 도구 (~500 토큰)
• standard: 25개 도구 (~2,500 토큰)
• full: 119개 도구 (~8,250 토큰, 기본값)

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

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

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

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

MCP 서버는 무료입니까?

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

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

네:

npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-api

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

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

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

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

• TypeScript: @modelcontextprotocol/sdk
• Python: mcp

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

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

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

포함 사항:

• MCP 서버 버전
• 클라이언트 이름 및 버전
• 운영 체제
• 관련 로그
• 재현 단계

다음 단계

• MCP란 무엇입니까?
• Claude Desktop 설정
• MCP 문제 해결