> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexinference.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP-Server

> Verbinden Sie Claude, Cursor und andere Agenten über das Model Context Protocol mit FlexInference.

Verwenden Sie den FlexInference Model Context Protocol (MCP)-Server, damit Code-Agenten Dokumente lesen und genehmigte Kontoaktionen durchführen können. Es handelt sich um einen Remote-Streaming-HTTP-Server unter:

```
https://mcp.flexinference.com/mcp
```

Der Server stellt zwei Tool-Gruppen bereit. Docs-Tools laufen ohne Anmeldung. Account-Tools erfordern OAuth, mit einem Scope pro Tool, bevor ein Agent die Nutzung lesen oder Schlüssel verwalten kann.

<Note>
  Der MCP-Server ist getrennt von der Inference-API unter
  `https://api.flexinference.com/v1`. Er führt niemals Inferenz aus und sieht
  niemals Ihre Prompts oder Antworten. Er verarbeitet nur Dokumente und
  Kontoaktionen.
</Note>

## Verbinden

Fügen Sie den Server jedem MCP-Client hinzu, der Remote-HTTP-Server unterstützt, einschließlich Claude und Cursor. Verwenden Sie diese Konfiguration:

<CodeGroup>
  ```json mcp.json theme={null}
  {
    "mcpServers": {
      "flexinference": {
        "type": "http",
        "url": "https://mcp.flexinference.com/mcp"
      }
    }
  }
  ```

  ```bash Claude Code theme={null}
  claude mcp add --transport http flexinference https://mcp.flexinference.com/mcp
  ```
</CodeGroup>

Der erste Aufruf eines Account-Tools öffnet einen Browser für die Dashboard-Anmeldung und zeigt dann einen Zustimmungsbildschirm mit den angeforderten Scopes an. Genehmigen oder schränken Sie die Scopes ein, und der Client speichert das Token. Docs-Tools erfordern keine Authentifizierung.

## Tools

### Docs-Tools (keine Anmeldung)

| Tool                  | Argumente              | Was es tut                                                                                                                                 |
| --------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `search_docs`         | `query` (erforderlich) | Durchsucht die FlexInference-Dokumentation und den vollständigen Fehlerkatalog und gibt die besten Treffer mit Links zurück.               |
| `get_error_reference` | `code` (optional)      | Sucht nach der Bedeutung eines FlexInference-Fehlercodes und wie er behoben werden kann. Lassen Sie `code` weg, um alle Codes aufzulisten. |

### Account-Tools (OAuth, je ein Scope)

| Tool                 | Scope          | Argumente              | Was es tut                                                                                                                   |
| -------------------- | -------------- | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `get_usage_summary`  | `usage:read`   | keine                  | Ihre Flex-Nutzung und Einsparungen, aufgeschlüsselt nach Modell.                                                             |
| `list_api_keys`      | `keys:read`    | keine                  | Ihre aktiven API-Schlüssel nach Name, den letzten 4 Zeichen und Erstellungsdatum. Niemals der vollständige Schlüssel.        |
| `create_api_key`     | `keys:write`   | `name` (erforderlich)  | Erstellt einen neuen `flex_live_`-Schlüssel. Der vollständige Schlüssel wird einmal zurückgegeben.                           |
| `revoke_api_key`     | `keys:write`   | `keyId` (erforderlich) | Widerruft einen Schlüssel anhand seiner ID.                                                                                  |
| `get_byok_status`    | `byok:status`  | keine                  | Welche Provider einen Schlüssel hinterlegt haben, als Ja oder Nein pro Provider. Niemals der Schlüssel.                      |
| `get_billing_status` | `billing:read` | keine                  | Ihre Zahlungsmethode (nur Marke und die letzten 4 Zeichen), Kontostatus, aufgelaufene Provision und nächstes Rechnungsdatum. |

## Authentifizierung und Scopes

Der Server implementiert OAuth 2.1 gegen dasselbe Identitätssystem wie das Dashboard, sodass ein Agent derselben Organisation zugeordnet wird. Jedes Account-Tool erfordert genau einen Scope. Der Zustimmungsbildschirm ermöglicht es Ihnen, angeforderte Scopes zu genehmigen oder einzuschränken.

Der Server verwendet keine Cookies oder serverseitigen Sitzungen. Jeder Tool-Aufruf trägt sein eigenes Token, und jedes Tool prüft seinen Scope, bevor es Daten liest oder ändert.

| Scope          | Gewährt                                                                                   |
| -------------- | ----------------------------------------------------------------------------------------- |
| `docs:read`    | Durchsucht die Dokumentation und liest den Fehlerkatalog. Jedem gewährt, keine Anmeldung. |
| `usage:read`   | Liest Ihre Nutzung und Einsparungen.                                                      |
| `keys:read`    | Listet Ihre API-Schlüssel auf.                                                            |
| `keys:write`   | Erstellt und widerruft API-Schlüssel.                                                     |
| `byok:status`  | Liest, welche Provider einen Schlüssel hinterlegt haben.                                  |
| `billing:read` | Liest Ihren Abrechnungsstatus.                                                            |

<Warning>
  Der MCP-Server akzeptiert niemals einen rohen Provider-Schlüssel. BYOK-Schlüssel werden
  verschlüsselt gespeichert und nicht pro Anfrage gesendet. Es gibt keinen Schreib-Scope für BYOK, und
  kein Tool akzeptiert einen `sk-...`, `AIza...` oder `sk-ant-...` Wert. `get_byok_status`
  meldet nur Ja oder Nein pro Provider. Fügen Sie Provider-Schlüssel hinzu oder rotieren Sie diese auf dem
  [Dashboard](https://www.flexinference.com/dashboard).
</Warning>