Assistenten mit SynCore verbinden

Dein Assistent spricht SynCore über eine Adresse und einen API-Key an. Wie du beides einträgst, hängt vom Client ab.

Adresse und Schlüssel

• Adresse: https://<deine-instanz>/api/mcp
• Schlüssel: im Header X-API-KEY. Schreib ihn nie in die Adresse.
• Übertragung: Streamable HTTP. SynCore antwortet mit JSON und braucht keine Sitzung.
• Protokollversionen: 2026-07-28 sowie 2025-11-25, 2025-06-18, 2025-03-26 und 2024-11-05. Dein Client wählt selbst.

Ob dein Assistent Werkzeuge einzeln aufruft oder Programme schickt, legt der Key fest, nicht die Adresse: Code-Mode einschalten und absichern.

Claude Code

Im Terminal:

claude mcp add --transport http syncore https://deine-instanz.example/api/mcp --header "X-API-KEY: syn_…"

Der Schlüssel steht danach in deiner lokalen Claude-Code-Konfiguration. Für ein gemeinsames Projekt legst du stattdessen eine .mcp.json an und holst den Schlüssel aus einer Umgebungsvariable:

{
  "mcpServers": {
    "syncore": {
      "type": "http",
      "url": "https://deine-instanz.example/api/mcp",
      "headers": { "X-API-KEY": "${SYNCORE_API_KEY}" }
    }
  }
}

Nimm einen eigenen Variablennamen wie SYNCORE_API_KEY. Ist die Variable nicht gesetzt, schickt Claude Code den Platzhalter unverändert und SynCore antwortet mit 401.

Cursor

In ~/.cursor/mcp.json (für dich) oder .cursor/mcp.json (im Projekt):

{
  "mcpServers": {
    "syncore": {
      "url": "https://deine-instanz.example/api/mcp",
      "headers": { "X-API-KEY": "${env:SYNCORE_API_KEY}" }
    }
  }
}

VS Code

In .vscode/mcp.json. VS Code fragt beim ersten Start nach dem Schlüssel und speichert ihn geschützt:

{
  "inputs": [
    { "type": "promptString", "id": "syncore-key", "description": "SynCore API-Key", "password": true }
  ],
  "servers": {
    "syncore": {
      "type": "http",
      "url": "https://deine-instanz.example/api/mcp",
      "headers": { "X-API-KEY": "${input:syncore-key}" }
    }
  }
}

Claude Desktop

Claude Desktop verbindet sich über das Hilfsprogramm mcp-remote (braucht Node.js 18 oder neuer). Trag in claude_desktop_config.json ein:

{
  "mcpServers": {
    "syncore": {
      "command": "npx",
      "args": ["mcp-remote", "https://deine-instanz.example/api/mcp", "--header", "X-API-KEY:${SYNCORE_API_KEY}"],
      "env": { "SYNCORE_API_KEY": "syn_…" }
    }
  }
}

Schreib nach X-API-KEY: kein Leerzeichen, unter Windows bricht der Aufruf sonst ab. Der Schlüssel steht in dieser Datei im Klartext, schütz sie wie ein Passwort.

Sicherheit

• Es gelten dieselben Prüfungen wie bei der App-Tools-API: Schlüssel, Scope, Actor-User, Rechte, Datenbereich, Eingabeschema und Audit-Log. Details stehen unter Sicherheit der API.
• SynCore nimmt den Schlüssel nur im Header X-API-KEY an, keine Anmeldung aus dem Browser und kein Cookie.
• Anfragen aus fremden Webseiten (Header Origin) lehnt SynCore mit 403 ab.
• Zum Ausprobieren eignet sich ?nur=lesen an der Adresse. So kann der Assistent nichts verändern, auch wenn der Actor-User es dürfte.