# MCP FAQ

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

## MCP란 무엇입니까?

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

[MCP란 무엇입니까?](/docs/mcp/what-is-mcp)를 참조하십시오.

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

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

전체 목록은 [MCP란 무엇입니까?](/docs/mcp/what-is-mcp)를 참조하십시오.

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

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

구성 예시는 [Claude Desktop 설정](/docs/mcp/claude-desktop)을 참조하십시오.

## 어떤 전송이 지원됩니까?

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

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

`claude_desktop_config.json`을 편집하십시오:

```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 설정](/docs/mcp/claude-desktop)을 참조하십시오.

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

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

[MCP 문제 해결](/docs/mcp/troubleshooting)을 참조하십시오.

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

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 문제 해결](/docs/mcp/troubleshooting)을 참조하십시오.

## MCP 서버는 무료입니까?

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

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

네:

```bash
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 클라이언트](/docs/mcp/custom-client)를 참조하십시오.

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

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

포함 사항:

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

## 다음 단계

- [MCP란 무엇입니까?](/docs/mcp/what-is-mcp)
- [Claude Desktop 설정](/docs/mcp/claude-desktop)
- [MCP 문제 해결](/docs/mcp/troubleshooting)