Zum Inhalt springen

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#

ServerURLInhalt
Alle Toolshttps://piqline.com/api/mcpjedes Tool, das der Schlüssel aufrufen kann, und ask_<agent> für jeden Agenten
Ein Agenthttps://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:

Shell
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}.

ArgumentRolle
messageDie Anfrage in natürlicher Sprache (erforderlich).
historyBisherige 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.

Eine Frage zur API oder ein Fehler auf dieser Seite? Schreiben Sie uns.