Leitfäden
MCP-Server
Die MCP-Server von Piqline, ihre Tools, die Tools ask_<agent> und die Annotationen.
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: 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:
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}.
| 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. 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 akzeptiert den Schlüssel.