Zum Inhalt springen

Leitfäden

Client verbinden

Piqline aus Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Zed, Mistral Le Chat, Copilot Studio, n8n, LangChain, dem Vercel SDK und jedem anderen MCP-Client verbinden: ein Block zum Kopieren pro Client.

Piqline hat zwei MCP-Server, beide über Streamable HTTP:

ServerURLAuthentifizierung
Vollständighttps://piqline.com/api/mcpAPI-Schlüssel im Header Authorization: Bearer …
Offene Türhttps://piqline.com/api/open/mcpkeine: was Piqline kann und seine öffentlichen Daten

Erstellen Sie den Schlüssel in einem kostenlosen Konto unter Einstellungen → API und MCP. Bewahren Sie ihn in der Umgebungsvariable PIQLINE_API_KEY auf statt in einer gemeinsam genutzten Datei.

ClientAnbieterSchlüssel im Header
Claude (claude.ai, Claude Desktop)Anthropicja
ChatGPTOpenAInein, nur offene Tür
Mistral Le ChatMistral AIja
Microsoft Copilot StudioMicrosoftja
Claude CodeAnthropicja
Codex CLIOpenAIja
Gemini CLIGoogleja
CursorAnysphereja
VS Code (GitHub Copilot)Microsoftja
ZedZed Industriesja
ClineClineja
Roo CodeRoo Codeja
ContinueContinueja
WindsurfCognitionüber das Relay
JetBrains AI AssistantJetBrainsüber das Relay
GooseBlocküber das Relay
Claude API (Messages)Anthropicja
OpenAI Responses APIOpenAIja
OpenAI Agents SDKOpenAIja
Vercel AI SDKVercelja
LangChain / LangGraphLangChainja
Google ADKGoogleja
n8nn8nja
CrewAICrewAIüber das Relay
LlamaIndexLlamaIndexüber das Relay
mcp-remote (any local client)Open sourceja

Assistenten und Apps#

Claude (claude.ai, Claude Desktop)#

Wo: Einstellungen › Konnektoren › Benutzerdefinierten Konnektor hinzufügen

Fügen Sie die Server-URL ein und ergänzen Sie unter „Request headers“ Authorization mit dem Wert Bearer gefolgt von Ihrem Schlüssel. Ohne Schlüssel funktioniert die URL der offenen Tür mit „No sign in“.

https://piqline.com/api/mcp

In den Tarifen Team und Enterprise wird ein am Konnektor gesetzter Header von allen Mitgliedern geteilt: Erstellen Sie einen eigenen, begrenzten Schlüssel.

Quelle: support.claude.com, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Hier noch nicht mit einem echten Schlüssel getestet.

ChatGPT#

Wo: Einstellungen › Apps › Entwicklermodus › Erstellen

ChatGPT akzeptiert keinen Schlüssel in einem Header: nur OAuth oder keine Authentifizierung. Verbinden Sie heute die offene Tür ohne Schlüssel; der vollständige Server kommt mit der Anmeldung über ein Piqline-Konto.

Text
https://piqline.com/api/open/mcp

Quelle: developers.openai.com, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Hier noch nicht mit einem echten Schlüssel getestet.

Mistral Le Chat#

Wo: Konnektoren › MCP-Konnektor hinzufügen (Admin)

Fügen Sie die Server-URL ein, wählen Sie die Authentifizierung per Bearer-Token und fügen Sie dann Ihren Schlüssel ein.

Text
https://piqline.com/api/mcp

Quelle: docs.mistral.ai, gelesen am 20. Nov. 2026 (aus der offiziellen Dokumentation zusammengesetzt). Hier noch nicht mit einem echten Schlüssel getestet.

Microsoft Copilot Studio#

Wo: Agent › Tools › Tool hinzufügen › Neues Tool › Model Context Protocol

Fügen Sie die Server-URL ein, wählen Sie „API key“, Ort „Header“, Name Authorization. Geben Sie beim Verbinden Bearer gefolgt von Ihrem Schlüssel ein.

Text
https://piqline.com/api/mcp

Quelle: learn.microsoft.com, gelesen am 20. Nov. 2026 (aus der offiziellen Dokumentation zusammengesetzt). Hier noch nicht mit einem echten Schlüssel getestet.

Coding-Agenten und Editoren#

Claude Code#

Wo: Terminal

Ein Befehl. Mit --scope project wird er in .mcp.json geschrieben und mit dem Team geteilt.

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

Quelle: code.claude.com, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Am 2026-11-20 mit einem echten Schlüssel getestet.

Codex CLI#

Wo: ~/.codex/config.toml

Codex liest den Schlüssel aus einer Umgebungsvariable: Exportieren Sie PIQLINE_API_KEY und fügen Sie dann den Server zur Konfiguration hinzu.

TOML
[mcp_servers.piqline]
url = "https://piqline.com/api/mcp"
bearer_token_env_var = "PIQLINE_API_KEY"

Quelle: learn.chatgpt.com, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Hier noch nicht mit einem echten Schlüssel getestet.

Gemini CLI#

Wo: Terminal oder ~/.gemini/settings.json

Ein Befehl oder der Block in settings.json. Der Schlüssel httpUrl wählt den HTTP-Transport (url würde das veraltete SSE bedeuten).

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

Quelle: geminicli.com, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Am 2026-11-20 mit einem echten Schlüssel getestet.

Cursor#

Wo: ~/.cursor/mcp.json oder .cursor/mcp.json

Der Block liest den Schlüssel aus einer Umgebungsvariable.

JSON
{
  "mcpServers": {
    "piqline": {
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:PIQLINE_API_KEY}" }
    }
  }
}

Quelle: cursor.com, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Hier noch nicht mit einem echten Schlüssel getestet.

VS Code (GitHub Copilot)#

Wo: .vscode/mcp.json

VS Code fragt beim ersten Verbinden nach dem Schlüssel und legt ihn in seinem Secret-Speicher ab. Das Format .vscode/mcp.json soll im Februar 2027 durch eine .mcp.json im Stammverzeichnis im Format von Claude Code ersetzt werden.

JSON
{
  "inputs": [
    { "type": "promptString", "id": "piqline-key", "description": "Piqline API key", "password": true }
  ],
  "servers": {
    "piqline": {
      "type": "http",
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer ${input:piqline-key}" }
    }
  }
}

Quelle: code.visualstudio.com, gelesen am 20. Nov. 2026 (aus der offiziellen Dokumentation zusammengesetzt). Hier noch nicht mit einem echten Schlüssel getestet.

Zed#

Wo: Zed settings.json

Fügen Sie den Server unter context_servers hinzu.

JSON
{
  "context_servers": {
    "piqline": {
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

Quelle: zed.dev, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Hier noch nicht mit einem echten Schlüssel getestet.

Cline#

Wo: cline_mcp_settings.json

Das Feld type ist erforderlich: Ohne es fällt Cline auf das veraltete SSE zurück.

JSON
{
  "mcpServers": {
    "piqline": {
      "type": "streamableHttp",
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

Quelle: docs.cline.bot, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Hier noch nicht mit einem echten Schlüssel getestet.

Roo Code#

Wo: .roo/mcp.json

Fügen Sie den Server zur Projektdatei hinzu.

JSON
{
  "mcpServers": {
    "piqline": {
      "type": "streamable-http",
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

Quelle: roocodeinc.github.io, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Hier noch nicht mit einem echten Schlüssel getestet.

Continue#

Wo: Continue config.yaml

Der Schlüssel bleibt in den Secrets von Continue.

YAML
mcpServers:
  - name: piqline
    type: streamable-http
    url: https://piqline.com/api/mcp
    requestOptions:
      headers:
        Authorization: "Bearer ${{ secrets.PIQLINE_API_KEY }}"

Quelle: docs.continue.dev, gelesen am 20. Nov. 2026 (aus der offiziellen Dokumentation zusammengesetzt). Hier noch nicht mit einem echten Schlüssel getestet.

Windsurf#

Wo: ~/.codeium/windsurf/mcp_config.json

Windsurf akzeptiert den HTTP-Transport und Header. Lehnt Ihre Version diesen Block ab, nutzen Sie das Relay mcp-remote weiter unten.

JSON
{
  "mcpServers": {
    "piqline": {
      "serverUrl": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

Quelle: docs.devin.ai, gelesen am 20. Nov. 2026 (Header nicht dokumentiert, Relay empfohlen). Hier noch nicht mit einem echten Schlüssel getestet.

JetBrains AI Assistant#

Wo: Einstellungen › Tools › AI Assistant › Model Context Protocol

Die Dokumentation zeigt keinen Header für einen Remote-Server: Nutzen Sie das Relay mcp-remote weiter unten.

Siehe das Relay mcp-remote.

Quelle: www.jetbrains.com, gelesen am 20. Nov. 2026 (Header nicht dokumentiert, Relay empfohlen). Hier noch nicht mit einem echten Schlüssel getestet.

Goose#

Wo: goose configure › Add extension › Remote

Fügen Sie eine HTTP-Remote-Extension mit der Server-URL und dem Header Authorization hinzu. Andernfalls nutzen Sie das Relay mcp-remote weiter unten.

Text
https://piqline.com/api/mcp

Quelle: goose-docs.ai, gelesen am 20. Nov. 2026 (Header nicht dokumentiert, Relay empfohlen). Hier noch nicht mit einem echten Schlüssel getestet.

APIs und Agenten-Frameworks#

Claude API (Messages)#

Wo: Anfrage an die Messages API

Der MCP-Konnektor der API ruft Piqline für das Modell auf. Der Schlüssel kommt in authorization_token. Den aktuellen Beta-Header finden Sie auf der Quellseite.

JSON
{
  "mcp_servers": [
    { "type": "url", "url": "https://piqline.com/api/mcp", "name": "piqline", "authorization_token": "piq_live_…" }
  ]
}

Quelle: platform.claude.com, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Hier noch nicht mit einem echten Schlüssel getestet.

OpenAI Responses API#

Wo: Tool mcp einer Responses-Anfrage

Der Schlüssel kommt in headers.

JSON
{
  "type": "mcp",
  "server_label": "piqline",
  "server_url": "https://piqline.com/api/mcp",
  "headers": { "Authorization": "Bearer piq_live_…" },
  "require_approval": "never"
}

Quelle: developers.openai.com, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Hier noch nicht mit einem echten Schlüssel getestet.

OpenAI Agents SDK#

Wo: Python

Ein Streamable-HTTP-Server mit dem Header.

Python
import os
from agents.mcp import MCPServerStreamableHttp

piqline = MCPServerStreamableHttp(params={
    "url": "https://piqline.com/api/mcp",
    "headers": {"Authorization": f"Bearer {os.environ['PIQLINE_API_KEY']}"},
})

Quelle: openai.github.io, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Am 2026-11-20 mit einem echten Schlüssel getestet.

Vercel AI SDK#

Wo: TypeScript

Der MCP-Client übergibt die Tools an generateText oder streamText.

TYPESCRIPT
import { createMCPClient } from "@ai-sdk/mcp";

const piqline = await createMCPClient({
  transport: {
    type: "http",
    url: "https://piqline.com/api/mcp",
    headers: { Authorization: `Bearer ${process.env.PIQLINE_API_KEY}` },
  },
});
const tools = await piqline.tools();

Quelle: ai-sdk.dev, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Am 2026-11-20 mit einem echten Schlüssel getestet.

LangChain / LangGraph#

Wo: Python

Piqline-Tools werden zu LangChain-Tools.

Python
import os
from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "piqline": {
        "transport": "http",
        "url": "https://piqline.com/api/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['PIQLINE_API_KEY']}"},
    }
})
tools = await client.get_tools()

Quelle: github.com, gelesen am 20. Nov. 2026 (Block aus der offiziellen Dokumentation). Am 2026-11-20 mit einem echten Schlüssel getestet.

Google ADK#

Wo: Python

Ein MCP-Toolset für einen ADK-Agenten.

Python
import os
from google.adk.tools.mcp_tool import McpToolset, StreamableHTTPConnectionParams

piqline = McpToolset(connection_params=StreamableHTTPConnectionParams(
    url="https://piqline.com/api/mcp",
    headers={"Authorization": f"Bearer {os.environ['PIQLINE_API_KEY']}"},
))

Quelle: adk.dev, gelesen am 20. Nov. 2026 (aus der offiziellen Dokumentation zusammengesetzt). Hier noch nicht mit einem echten Schlüssel getestet.

n8n#

Wo: Node „MCP Client Tool“ eines KI-Agenten

Fügen Sie die Server-URL ein, wählen Sie den HTTP-Transport und die Authentifizierung „Bearer“ und fügen Sie dann Ihren Schlüssel ein.

Text
https://piqline.com/api/mcp

Quelle: docs.n8n.io, gelesen am 20. Nov. 2026 (aus der offiziellen Dokumentation zusammengesetzt). Hier noch nicht mit einem echten Schlüssel getestet.

CrewAI#

Wo: Python

CrewAI verbindet sich über Streamable HTTP; seine Dokumentation zeigt keinen Header. Nutzen Sie das Relay mcp-remote oder LangChain.

Siehe das Relay mcp-remote.

Quelle: docs.crewai.com, gelesen am 20. Nov. 2026 (Header nicht dokumentiert, Relay empfohlen). Hier noch nicht mit einem echten Schlüssel getestet.

LlamaIndex#

Wo: Python

LlamaIndex verbindet sich mit einem HTTP-Server; seine Dokumentation zeigt keinen Header. Nutzen Sie das Relay mcp-remote.

Siehe das Relay mcp-remote.

Quelle: developers.llamaindex.ai, gelesen am 20. Nov. 2026 (Header nicht dokumentiert, Relay empfohlen). Hier noch nicht mit einem echten Schlüssel getestet.

Jeder andere Client#

mcp-remote (any local client)#

Wo: Die MCP-Konfigurationsdatei Ihres Clients

Für einen Client, der nur mit einem lokalen Prozess (stdio) spricht: mcp-remote leitet an den HTTP-Server weiter. Der Wert des Headers steht in env, ohne Leerzeichen in den Argumenten (manche Clients trennen an Leerzeichen).

JSON
{
  "mcpServers": {
    "piqline": {
      "command": "npx",
      "args": ["mcp-remote", "https://piqline.com/api/mcp", "--transport", "http-only", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer piq_live_…" }
    }
  }
}

Quelle: github.com, gelesen am 20. Nov. 2026 (aus der offiziellen Dokumentation zusammengesetzt). Am 2026-11-20 mit einem echten Schlüssel getestet.

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