# MCP FAQ

Vanliga frågor om Synapse MCP-server.

## Vad är MCP?

MCP (Model Context Protocol) är en öppen standard av Anthropic för
LLM-verktygsintegration. Istället för att klistra in API-dokumentation i
prompter registrerar ni verktyg hos en MCP-server, och LLM:en anropar dem som
inbyggda funktioner.

Se [Vad är MCP?](/docs/mcp/what-is-mcp).

## Hur många verktyg exponerar Synapse MCP?

**79 verktyg** i 12 kategorier: minne, chatt, schemaläggare, uppgifter, skript,
datorer, push, användare, verktyg, visualisering, delning, webhooks, webbläsare.

Se [Vad är MCP?](/docs/mcp/what-is-mcp) för fullständig lista.

## Vilka MCP-klienter stöds?

- Claude Desktop (macOS, Windows)
- Claude Code (terminal)
- Cursor (IDE)
- Continue.dev (VS Code, JetBrains)
- Cline (VS Code)
- Vilken MCP-kompatibel klient som helst

Se [Claude Desktop-konfiguration](/docs/mcp/claude-desktop) för konfigurationsexempel.

## Vilka transporter stöds?

1. **stdio** (lokal, rekommenderas för skrivbord)
2. **HTTP/SSE** (fjärr, multitenant)
3. **WebSocket** (mobil, hög volym)

## Hur konfigurerar jag Claude Desktop?

Redigera `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"
      }
    }
  }
}
```

Se [Claude Desktop-konfiguration](/docs/mcp/claude-desktop).

## Varför visas inte verktyg i Claude Desktop?

1. **Starta om Claude Desktop helt** (Cmd+Q på macOS)
2. **Kontrollera att konfigurationsfilen är giltig JSON**
3. **Verifiera att Node.js 18+** är installerat
4. **Kontrollera MCP-loggar**: `~/Library/Logs/Claude/mcp.log`

Se [MCP-felsökning](/docs/mcp/troubleshooting).

## Hur använder jag en annan mind?

Ändra `SYNAPSE_MIND_KEY` i er MCP-konfiguration och starta om klienten.

För flera minds, kör flera MCP-serverinstanser med olika Mind Keys.

## Kan jag begränsa vilka verktyg som exponeras?

Ja, använd **verktygsprofiler**:

- `minimal`: 8 sammansatta verktyg (~500 tokens)
- `standard`: 25 verktyg (~2 500 tokens)
- `full`: 119 verktyg (~8 250 tokens, standard)

Sätt via `MCP_PROFILE`-miljövariabel eller `Mcp-Tool-Profile`-header.

## Hur felsöker jag MCP-problem?

1. **Kör MCP-server manuellt**: `npx -y synapse-mcp-api@latest`
2. **Kontrollera klientloggar** (varierar per klient)
3. **Verifiera att Mind Key fungerar**: `curl -H "Authorization: Bearer mk_..." .../memory/recall`
4. **Kontrollera Synapse-hälsa**: `curl https://synapse.schaefer.zone/health`

Se [MCP-felsökning](/docs/mcp/troubleshooting).

## Är MCP-servern gratis?

Ja. npm-paketet `synapse-mcp-api` är öppen källkod. Den värdhostade
MCP-servern på `synapse-mcp.schaefer.zone` är gratis för offentligt bruk.

## Kan jag köra MCP-servern egenvärd?

Ja:

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

## Hur skiljer sig MCP från direkta API-anrop?

| Aspekt | Direkt API | MCP |
|--------|-----------|-----|
| LLM behöver veta | URL:er, headers, auth | Bara verktygsnamn |
| Auth-hantering | Manuell | Automatisk (miljövariabel) |
| Verktygsupptäckt | Läs /endpoints | Automatisk via MCP-protokoll |
| Felhantering | Manuell | Standardiserad |
| Bäst för | Anpassade integrationer | LLM-agenter |

## Kan jag bygga en egen MCP-klient?

Ja. Använd det officiella MCP-SDK:et:

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

Se [Anpassad MCP-klient](/docs/mcp/custom-client).

## Hur rapporterar jag MCP-buggar?

Öppna ett ärende: <https://gitlab.com/schaefer-services/synapse-mcp/-/issues>

Inkludera:

- MCP-serverversion
- Klientnamn och version
- Operativsystem
- Relevanta loggar
- Steg för att reproducera

## Nästa steg

- [Vad är MCP?](/docs/mcp/what-is-mcp)
- [Claude Desktop-konfiguration](/docs/mcp/claude-desktop)
- [MCP-felsökning](/docs/mcp/troubleshooting)