# MCP-Server

> Die MCP-Server von Piqline, ihre Tools, die Tools ask_<agent> und die Annotationen.

Source: https://piqline.com/de/docs/api/mcp

Der MCP-Server stellt dieselben Tools bereit wie die API, dazu ein Tool pro Agent. Er nutzt den Transport „Streamable HTTP“ ohne Sitzungen: Jede Anfrage steht für sich. Der Schlüssel wird wie bei der API im Header `Authorization` gesendet.

## Die Server

| Server | URL | Inhalt |
| --- | --- | --- |
| Alle Tools | `https://piqline.com/api/mcp` | jedes Tool, das der Schlüssel aufrufen kann, und `ask_<agent>` für jeden Agenten |
| Ein Agent | `https://piqline.com/api/mcp/{agent}` | die Tools dieses Agenten und sein `ask_<agent>` |

`{agent}` ist `piqline`, `requete`, `facebook`, `linkedin`, `upwork` oder `onboarding`. Der Server für einen einzelnen Agenten eignet sich für Clients, die die Zahl der Tools begrenzen.

`tools/list` zeigt nur die Tools, die der Schlüssel aufrufen kann: Ein fehlendes Tool verlangt einen Scope, den der Schlüssel nicht hat. Die Tools `ask_<agent>` verlangen den Scope `agents`, und `ask_onboarding` die Rolle Owner oder Admin.

## Einen Client verbinden

Jeder Client hat seinen Block zum Kopieren, geprüft gegen seine offizielle Dokumentation, unter [Client verbinden](/de/docs/api/clients): Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Zed, Cline, Mistral Le Chat, Copilot Studio, n8n, LangChain, das Vercel SDK und ein Relay für jeden lokalen Client. Zum Beispiel in Claude Code:

```bash
claude mcp add --transport http piqline https://piqline.com/api/mcp \
  --header "Authorization: Bearer $PIQLINE_API_KEY"
```

## Die Tools ask_<agent>

`ask_piqline`, `ask_requete`, `ask_facebook`, `ask_linkedin`, `ask_upwork` und `ask_onboarding` übergeben eine ganze Anfrage an den jeweiligen Agenten, wie [`POST /api/v1/agents/{agent}`](/de/docs/api/agents).

| Argument | Rolle |
| --- | --- |
| `message` | Die Anfrage in natürlicher Sprache (erforderlich). |
| `history` | Bisherige Wortwechsel mit diesem Agenten, ältester zuerst: Objekte `{ "role": "user" or "assistant", "text": "…" }`. |

Die Antwort enthält den Text des Agenten. Hält der Agent für eine Frage oder für eine zu bestätigende Aktion an, sagt die Antwort das und nennt das aufzurufende Tool.

## Annotationen

Jedes Tool deklariert `readOnlyHint`, `destructiveHint` und `openWorldHint`. Ein Client kann sie nutzen, um vor Tools, die schreiben, löschen oder live lesen, um Bestätigung zu bitten.

## Fehler

Ein Tool, das fehlschlägt, antwortet mit `isError: true` und einer lesbaren Meldung. Ablehnungen, die vor dem Tool erfolgen (Schlüssel, Scope, Limit), sind HTTP-Antworten `401`, `403` oder `429` als `application/problem+json`, beschrieben unter [Fehler](/de/docs/api/errors). Beide Fälle erscheinen im Anfrageverlauf unter Einstellungen → API und MCP.

## Anmeldung mit Konto

ChatGPT akzeptiert nur die OAuth-Anmeldung oder keine Authentifizierung: Heute verbindet es sich mit der offenen Tür, `https://piqline.com/api/open/mcp`. Die Anmeldung mit einem Piqline-Konto (OAuth) ist in Vorbereitung. Jeder andere Client auf der Seite [Client verbinden](/de/docs/api/clients) akzeptiert den Schlüssel.
