# FAQ MCP

Częste pytania dotyczące serwera MCP Synapse.

## Czym jest MCP?

MCP (Model Context Protocol) to otwarty standard Anthropic dla integracji LLM z
narzędziami. Zamiast wklejać dokumentację API do promptów, rejestruje się
narzędzia w serwerze MCP, a LLM wywołuje je jako funkcje natywne.

Patrz [Czym jest MCP?](/docs/mcp/what-is-mcp).

## Ile narzędzi udostępnia Synapse MCP?

**79 narzędzi** w 12 kategoriach: memory, chat, scheduler, tasks, scripts,
computers, push, user, utility, visualization, sharing, webhooks, browser.

Pełna lista w sekcji [Czym jest MCP?](/docs/mcp/what-is-mcp).

## Które klienty MCP są obsługiwane?

- Claude Desktop (macOS, Windows)
- Claude Code (terminal)
- Cursor (IDE)
- Continue.dev (VS Code, JetBrains)
- Cline (VS Code)
- Dowolny klient zgodny z MCP

Przykłady konfiguracji w sekcji [Konfiguracja Claude Desktop](/docs/mcp/claude-desktop).

## Jakie transporty są obsługiwane?

1. **stdio** (lokalny, zalecany dla komputerów biurkowych)
2. **HTTP/SSE** (zdalny, wielodostępny)
3. **WebSocket** (mobilny, duży ruch)

## Jak skonfigurować Claude Desktop?

Edytować `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"
      }
    }
  }
}
```

Patrz [Konfiguracja Claude Desktop](/docs/mcp/claude-desktop).

## Dlaczego narzędzia nie pojawiają się w Claude Desktop?

1. **W pełni zrestartować Claude Desktop** (Cmd+Q na macOS)
2. **Sprawdzić, czy plik konfiguracyjny jest poprawnym JSON-em**
3. **Zweryfikować Node.js 18+** zainstalowany
4. **Sprawdzić logi MCP**: `~/Library/Logs/Claude/mcp.log`

Patrz [Rozwiązywanie problemów MCP](/docs/mcp/troubleshooting).

## Jak używać innego umysłu?

Zmienić `SYNAPSE_MIND_KEY` w konfiguracji MCP i zrestartować klienta.

Dla wielu umysłów uruchomić wiele instancji serwera MCP z różnymi Mind Key.

## Czy mogę ograniczyć, które narzędzia są udostępniane?

Tak, użyć **Profili narzędzi**:

- `minimal`: 8 narzędzi złożonych (około 500 tokenów)
- `standard`: 25 narzędzi (około 2 500 tokenów)
- `full`: 119 narzędzi (około 8 250 tokenów, domyślnie)

Ustawić przez zmienną środowiskową `MCP_PROFILE` lub nagłówek `Mcp-Tool-Profile`.

## Jak debugować problemy MCP?

1. **Uruchomić serwer MCP ręcznie**: `npx -y synapse-mcp-api@latest`
2. **Sprawdzić logi klienta** (różne w zależności od klienta)
3. **Zweryfikować działanie Mind Key**: `curl -H "Authorization: Bearer mk_..." .../memory/recall`
4. **Sprawdzić kondycję Synapse**: `curl https://synapse.schaefer.zone/health`

Patrz [Rozwiązywanie problemów MCP](/docs/mcp/troubleshooting).

## Czy serwer MCP jest darmowy?

Tak. Pakiet npm `synapse-mcp-api` jest open source. Hostowany serwer MCP pod
adresem `synapse-mcp.schaefer.zone` jest darmowy do użytku publicznego.

## Czy mogę hostować serwer MCP samodzielnie?

Tak:

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

## Czym MCP różni się od bezpośrednich wywołań API?

| Aspekt | Bezpośrednie API | MCP |
|--------|-----------|-----|
| LLM musi znać | URL-e, nagłówki, autoryzację | Tylko nazwy narzędzi |
| Obsługa autoryzacji | Ręczna | Automatyczna (zmienna środowiskowa) |
| Wykrywanie narzędzi | Czytanie /endpoints | Automatyczne przez protokół MCP |
| Obsługa błędów | Ręczna | Ustandaryzowana |
| Najlepsze do | Niestandardowych integracji | Agentów LLM |

## Czy mogę zbudować własnego klienta MCP?

Tak. Użyć oficjalnego SDK MCP:

- TypeScript: `@modelcontextprotocol/sdk`
- Python: `mcp`

Patrz [Niestandardowy klient MCP](/docs/mcp/custom-client).

## Jak zgłaszać błędy MCP?

Otworzyć zgłoszenie: <https://gitlab.com/schaefer-services/synapse-mcp/-/issues>

Dołączyć:

- Wersję serwera MCP
- Nazwę i wersję klienta
- System operacyjny
- Istotne logi
- Kroki reprodukcji

## Następne kroki

- [Czym jest MCP?](/docs/mcp/what-is-mcp)
- [Konfiguracja Claude Desktop](/docs/mcp/claude-desktop)
- [Rozwiązywanie problemów MCP](/docs/mcp/troubleshooting)