Vai al contenuto

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:

ServerURLAutenticazione
Completohttps://piqline.com/api/mcpchiave API nell'header Authorization: Bearer …
Porta apertahttps://piqline.com/api/open/mcpnessuna: 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.

ClientFornitoreChiave in un header
Claude (claude.ai, Claude Desktop)Anthropicsì
ChatGPTOpenAIno, solo porta aperta
Mistral Le ChatMistral AIsì
Microsoft Copilot StudioMicrosoftsì
Claude CodeAnthropicsì
Codex CLIOpenAIsì
Gemini CLIGooglesì
CursorAnyspheresì
VS Code (GitHub Copilot)Microsoftsì
ZedZed Industriessì
ClineClinesì
Roo CodeRoo Codesì
ContinueContinuesì
WindsurfCognitiontramite il relay
JetBrains AI AssistantJetBrainstramite il relay
GooseBlocktramite il relay
Claude API (Messages)Anthropicsì
OpenAI Responses APIOpenAIsì
OpenAI Agents SDKOpenAIsì
Vercel AI SDKVercelsì
LangChain / LangGraphLangChainsì
Google ADKGooglesì
n8nn8nsì
CrewAICrewAItramite il relay
LlamaIndexLlamaIndextramite il relay
mcp-remote (any local client)Open sourcesì

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/mcp

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.

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

Fonte: 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.

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

Fonte: 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.

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

Fonte: 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"

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.

TOML
[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

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.

JSON
{
  "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.

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}" }
    }
  }
}

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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

YAML
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.

JSON
{
  "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.

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

Fonte: 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.

JSON
{
  "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.

JSON
{
  "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.

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']}"},
})

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.

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();

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.

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()

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.

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']}"},
))

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.

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

Fonte: 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).

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_…" }
    }
  }
}

Fonte: github.com, letta il 20 nov 2026 (assemblato a partire dalla documentazione ufficiale). Testato con una chiave reale il 2026-11-20.

Una domanda sull'API, o un errore in questa pagina? Scrivici.