Guide
Collegare il client
Collega Piqline da Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Zed, Mistral Le Chat, Copilot Studio, n8n, LangChain, l'SDK Vercel e qualsiasi altro client MCP: un blocco da copiare per client.
Piqline ha due server MCP, entrambi su Streamable HTTP:
| Server | URL | Autenticazione |
|---|---|---|
| Completo | https://piqline.com/api/mcp | chiave API nell'header Authorization: Bearer … |
| Porta aperta | https://piqline.com/api/open/mcp | nessuna: ciò che Piqline sa fare e i suoi dati pubblici |
Crea la chiave in un account gratuito, Impostazioni → API e MCP. Conservala in una variabile d'ambiente PIQLINE_API_KEY piuttosto che in un file condiviso.
| Client | Fornitore | Chiave in un header |
|---|---|---|
| Claude (claude.ai, Claude Desktop) | Anthropic | sì |
| ChatGPT | OpenAI | no, solo porta aperta |
| Mistral Le Chat | Mistral AI | sì |
| Microsoft Copilot Studio | Microsoft | sì |
| Claude Code | Anthropic | sì |
| Codex CLI | OpenAI | sì |
| Gemini CLI | sì | |
| Cursor | Anysphere | sì |
| VS Code (GitHub Copilot) | Microsoft | sì |
| Zed | Zed Industries | sì |
| Cline | Cline | sì |
| Roo Code | Roo Code | sì |
| Continue | Continue | sì |
| Windsurf | Cognition | tramite il relay |
| JetBrains AI Assistant | JetBrains | tramite il relay |
| Goose | Block | tramite il relay |
| Claude API (Messages) | Anthropic | sì |
| OpenAI Responses API | OpenAI | sì |
| OpenAI Agents SDK | OpenAI | sì |
| Vercel AI SDK | Vercel | sì |
| LangChain / LangGraph | LangChain | sì |
| Google ADK | sì | |
| n8n | n8n | sì |
| CrewAI | CrewAI | tramite il relay |
| LlamaIndex | LlamaIndex | tramite il relay |
| mcp-remote (any local client) | Open source | sì |
Assistenti e app#
Claude (claude.ai, Claude Desktop)#
Dove: Settings › Connectors › Add custom connector
Incolla l'URL del server, poi sotto «Request headers» aggiungi Authorization con il valore Bearer seguito dalla tua chiave. Senza chiave, l'URL della porta aperta funziona con «No sign in».
https://piqline.com/api/mcpAuthorization: Bearer piq_live_…Nei piani Team ed Enterprise, un header impostato sul connettore è condiviso da tutti i membri: crea una chiave dedicata e con un limite.
Fonte: support.claude.com, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
ChatGPT#
Dove: Settings › Apps › Developer mode › Create
ChatGPT non accetta una chiave in un header: solo OAuth o nessuna autenticazione. Collega oggi la porta aperta, senza chiave; il server completo arriverà con l'accesso tramite un account Piqline.
https://piqline.com/api/open/mcpFonte: developers.openai.com, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
Mistral Le Chat#
Dove: Connectors › Add MCP connector (admin)
Incolla l'URL del server, scegli l'autenticazione con token Bearer, poi incolla la tua chiave.
https://piqline.com/api/mcpFonte: docs.mistral.ai, letta il 20 nov 2026 (assemblato a partire dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
Microsoft Copilot Studio#
Dove: Agent › Tools › Add a tool › New tool › Model Context Protocol
Incolla l'URL del server, scegli «API key», posizione «Header», nome Authorization. Durante il collegamento, inserisci Bearer seguito dalla tua chiave.
https://piqline.com/api/mcpFonte: learn.microsoft.com, letta il 20 nov 2026 (assemblato a partire dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
Agenti di coding ed editor#
Claude Code#
Dove: Terminale
Un solo comando. Aggiungi --scope project per scriverlo in .mcp.json e condividerlo con il team.
claude mcp add --transport http piqline https://piqline.com/api/mcp \
--header "Authorization: Bearer $PIQLINE_API_KEY"{
"mcpServers": {
"piqline": {
"type": "http",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer ${PIQLINE_API_KEY}" }
}
}
}Fonte: code.claude.com, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Testato con una chiave reale il 2026-11-20.
Codex CLI#
Dove: ~/.codex/config.toml
Codex legge la chiave da una variabile d'ambiente: esporta PIQLINE_API_KEY, poi aggiungi il server alla configurazione.
[mcp_servers.piqline]
url = "https://piqline.com/api/mcp"
bearer_token_env_var = "PIQLINE_API_KEY"Fonte: learn.chatgpt.com, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
Gemini CLI#
Dove: Terminale o ~/.gemini/settings.json
Un solo comando, oppure il blocco in settings.json. La chiave httpUrl seleziona il trasporto HTTP (url indicherebbe il vecchio SSE).
gemini mcp add --transport http \
--header "Authorization: Bearer $PIQLINE_API_KEY" piqline https://piqline.com/api/mcp{
"mcpServers": {
"piqline": {
"httpUrl": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Fonte: geminicli.com, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Testato con una chiave reale il 2026-11-20.
Cursor#
Dove: ~/.cursor/mcp.json o .cursor/mcp.json
Il blocco legge la chiave da una variabile d'ambiente.
{
"mcpServers": {
"piqline": {
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer ${env:PIQLINE_API_KEY}" }
}
}
}Fonte: cursor.com, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
VS Code (GitHub Copilot)#
Dove: .vscode/mcp.json
VS Code chiede la chiave alla prima connessione e la conserva nel proprio archivio dei segreti. Il formato .vscode/mcp.json è annunciato come sostituito a febbraio 2027 da un .mcp.json nella radice, nel formato di Claude Code.
{
"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}" }
}
}
}Fonte: code.visualstudio.com, letta il 20 nov 2026 (assemblato a partire dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
Zed#
Dove: settings.json di Zed
Aggiungi il server sotto context_servers.
{
"context_servers": {
"piqline": {
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Fonte: zed.dev, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
Cline#
Dove: cline_mcp_settings.json
Il campo type è obbligatorio: senza di esso, Cline ripiega sul vecchio SSE.
{
"mcpServers": {
"piqline": {
"type": "streamableHttp",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Fonte: docs.cline.bot, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
Roo Code#
Dove: .roo/mcp.json
Aggiungi il server al file del progetto.
{
"mcpServers": {
"piqline": {
"type": "streamable-http",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Fonte: roocodeinc.github.io, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
Continue#
Dove: config.yaml di Continue
La chiave resta nei segreti di Continue.
mcpServers:
- name: piqline
type: streamable-http
url: https://piqline.com/api/mcp
requestOptions:
headers:
Authorization: "Bearer ${{ secrets.PIQLINE_API_KEY }}"Fonte: docs.continue.dev, letta il 20 nov 2026 (assemblato a partire dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
Windsurf#
Dove: ~/.codeium/windsurf/mcp_config.json
Windsurf accetta il trasporto HTTP e gli header. Se la tua versione rifiuta questo blocco, usa il relay mcp-remote qui sotto.
{
"mcpServers": {
"piqline": {
"serverUrl": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Fonte: docs.devin.ai, letta il 20 nov 2026 (header non documentati, relay consigliato). Non ancora testato qui con una chiave reale.
JetBrains AI Assistant#
Dove: Settings › Tools › AI Assistant › Model Context Protocol
La documentazione non mostra alcun header per un server remoto: usa il relay mcp-remote qui sotto.
Vedi il relay mcp-remote.
Fonte: www.jetbrains.com, letta il 20 nov 2026 (header non documentati, relay consigliato). Non ancora testato qui con una chiave reale.
Goose#
Dove: goose configure › Add extension › Remote
Aggiungi un'estensione HTTP remota con l'URL del server e l'header Authorization. In alternativa, usa il relay mcp-remote qui sotto.
https://piqline.com/api/mcpFonte: goose-docs.ai, letta il 20 nov 2026 (header non documentati, relay consigliato). Non ancora testato qui con una chiave reale.
API e framework di agenti#
Claude API (Messages)#
Dove: Richiesta alla Messages API
Il connettore MCP dell'API chiama Piqline per conto del modello. La chiave va in authorization_token. Consulta la pagina della fonte per l'header beta attuale.
{
"mcp_servers": [
{ "type": "url", "url": "https://piqline.com/api/mcp", "name": "piqline", "authorization_token": "piq_live_…" }
]
}Fonte: platform.claude.com, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
OpenAI Responses API#
Dove: Tool mcp di una richiesta Responses
La chiave va in headers.
{
"type": "mcp",
"server_label": "piqline",
"server_url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" },
"require_approval": "never"
}Fonte: developers.openai.com, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
OpenAI Agents SDK#
Dove: Python
Un server Streamable HTTP con l'header.
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']}"},
})Fonte: openai.github.io, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Testato con una chiave reale il 2026-11-20.
Vercel AI SDK#
Dove: TypeScript
Il client MCP passa i tool a generateText o streamText.
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();Fonte: ai-sdk.dev, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Testato con una chiave reale il 2026-11-20.
LangChain / LangGraph#
Dove: Python
I tool Piqline diventano tool LangChain.
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()Fonte: github.com, letta il 20 nov 2026 (blocco tratto dalla documentazione ufficiale). Testato con una chiave reale il 2026-11-20.
Google ADK#
Dove: Python
Un toolset MCP per un agente ADK.
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']}"},
))Fonte: adk.dev, letta il 20 nov 2026 (assemblato a partire dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
n8n#
Dove: Nodo «MCP Client Tool» di un agente AI
Incolla l'URL del server, scegli il trasporto HTTP e l'autenticazione «Bearer», poi incolla la tua chiave.
https://piqline.com/api/mcpFonte: docs.n8n.io, letta il 20 nov 2026 (assemblato a partire dalla documentazione ufficiale). Non ancora testato qui con una chiave reale.
CrewAI#
Dove: Python
CrewAI si connette via Streamable HTTP; la sua documentazione non mostra alcun header. Usa il relay mcp-remote, oppure LangChain.
Vedi il relay mcp-remote.
Fonte: docs.crewai.com, letta il 20 nov 2026 (header non documentati, relay consigliato). Non ancora testato qui con una chiave reale.
LlamaIndex#
Dove: Python
LlamaIndex si connette a un server HTTP; la sua documentazione non mostra alcun header. Usa il relay mcp-remote.
Vedi il relay mcp-remote.
Fonte: developers.llamaindex.ai, letta il 20 nov 2026 (header non documentati, relay consigliato). Non ancora testato qui con una chiave reale.
Qualsiasi altro client#
mcp-remote (any local client)#
Dove: Il file di configurazione MCP del tuo client
Per un client che parla solo con un processo locale (stdio): mcp-remote fa da relay al server HTTP. Il valore dell'header sta in env, senza spazi negli argomenti (alcuni client dividono sugli spazi).
{
"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_…" }
}
}
}Fonte: github.com, letta il 20 nov 2026 (assemblato a partire dalla documentazione ufficiale). Testato con una chiave reale il 2026-11-20.