Guias
Conectar cliente
Conecte o Piqline pelo Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Zed, Mistral Le Chat, Copilot Studio, n8n, LangChain, o Vercel SDK e qualquer outro cliente MCP: um bloco para copiar por cliente.
O Piqline tem dois servidores MCP, ambos em Streamable HTTP:
| Servidor | URL | Autenticação |
|---|---|---|
| Completo | https://piqline.com/api/mcp | chave de API no cabeçalho Authorization: Bearer … |
| Porta aberta | https://piqline.com/api/open/mcp | nenhuma: o que o Piqline sabe fazer e seus dados públicos |
Crie a chave em uma conta gratuita, em Configurações → API e MCP. Guarde-a em uma variável de ambiente PIQLINE_API_KEY em vez de em um arquivo compartilhado.
| Cliente | Fornecedor | Chave em um cabeçalho |
|---|---|---|
| Claude (claude.ai, Claude Desktop) | Anthropic | sim |
| ChatGPT | OpenAI | não, somente porta aberta |
| Mistral Le Chat | Mistral AI | sim |
| Microsoft Copilot Studio | Microsoft | sim |
| Claude Code | Anthropic | sim |
| Codex CLI | OpenAI | sim |
| Gemini CLI | sim | |
| Cursor | Anysphere | sim |
| VS Code (GitHub Copilot) | Microsoft | sim |
| Zed | Zed Industries | sim |
| Cline | Cline | sim |
| Roo Code | Roo Code | sim |
| Continue | Continue | sim |
| Windsurf | Cognition | pelo relay |
| JetBrains AI Assistant | JetBrains | pelo relay |
| Goose | Block | pelo relay |
| Claude API (Messages) | Anthropic | sim |
| OpenAI Responses API | OpenAI | sim |
| OpenAI Agents SDK | OpenAI | sim |
| Vercel AI SDK | Vercel | sim |
| LangChain / LangGraph | LangChain | sim |
| Google ADK | sim | |
| n8n | n8n | sim |
| CrewAI | CrewAI | pelo relay |
| LlamaIndex | LlamaIndex | pelo relay |
| mcp-remote (any local client) | Open source | sim |
Assistentes e aplicativos#
Claude (claude.ai, Claude Desktop)#
Onde: Configurações › Conectores › Adicionar conector personalizado
Cole a URL do servidor e, em “Request headers”, adicione Authorization com o valor Bearer seguido da sua chave. Sem chave, a URL da porta aberta funciona com “No sign in”.
https://piqline.com/api/mcpAuthorization: Bearer piq_live_…Nos planos Team e Enterprise, um cabeçalho definido no conector é compartilhado por todos os membros: crie uma chave dedicada e com limite.
Fonte: support.claude.com, lida em 20 nov. 2026 (bloco da documentação oficial). Ainda não testado aqui com uma chave real.
ChatGPT#
Onde: Configurações › Apps › Modo desenvolvedor › Criar
O ChatGPT não aceita uma chave em um cabeçalho: apenas OAuth ou nenhuma autenticação. Conecte hoje a porta aberta, sem chave; o servidor completo virá com o login por uma conta Piqline.
https://piqline.com/api/open/mcpFonte: developers.openai.com, lida em 20 nov. 2026 (bloco da documentação oficial). Ainda não testado aqui com uma chave real.
Mistral Le Chat#
Onde: Conectores › Adicionar conector MCP (admin)
Cole a URL do servidor, escolha a autenticação por Bearer token e cole a sua chave.
https://piqline.com/api/mcpFonte: docs.mistral.ai, lida em 20 nov. 2026 (montado a partir da documentação oficial). Ainda não testado aqui com uma chave real.
Microsoft Copilot Studio#
Onde: Agente › Ferramentas › Adicionar uma ferramenta › Nova ferramenta › Model Context Protocol
Cole a URL do servidor, escolha “API key”, local “Header”, nome Authorization. Na conexão, informe Bearer seguido da sua chave.
https://piqline.com/api/mcpFonte: learn.microsoft.com, lida em 20 nov. 2026 (montado a partir da documentação oficial). Ainda não testado aqui com uma chave real.
Agentes de código e editores#
Claude Code#
Onde: Terminal
Um único comando. Adicione --scope project para gravá-lo em .mcp.json e compartilhá-lo com a equipe.
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, lida em 20 nov. 2026 (bloco da documentação oficial). Testado com uma chave real em 2026-11-20.
Codex CLI#
Onde: ~/.codex/config.toml
O Codex lê a chave de uma variável de ambiente: exporte PIQLINE_API_KEY e depois adicione o servidor à configuração.
[mcp_servers.piqline]
url = "https://piqline.com/api/mcp"
bearer_token_env_var = "PIQLINE_API_KEY"Fonte: learn.chatgpt.com, lida em 20 nov. 2026 (bloco da documentação oficial). Ainda não testado aqui com uma chave real.
Gemini CLI#
Onde: Terminal ou ~/.gemini/settings.json
Um único comando, ou o bloco em settings.json. A chave httpUrl seleciona o transporte HTTP (url significaria SSE legado).
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, lida em 20 nov. 2026 (bloco da documentação oficial). Testado com uma chave real em 2026-11-20.
Cursor#
Onde: ~/.cursor/mcp.json ou .cursor/mcp.json
O bloco lê a chave de uma variável de ambiente.
{
"mcpServers": {
"piqline": {
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer ${env:PIQLINE_API_KEY}" }
}
}
}Fonte: cursor.com, lida em 20 nov. 2026 (bloco da documentação oficial). Ainda não testado aqui com uma chave real.
VS Code (GitHub Copilot)#
Onde: .vscode/mcp.json
O VS Code pede a chave na primeira conexão e a guarda no seu cofre de segredos. O formato .vscode/mcp.json tem substituição anunciada para fevereiro de 2027 por um .mcp.json na raiz, no formato do 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, lida em 20 nov. 2026 (montado a partir da documentação oficial). Ainda não testado aqui com uma chave real.
Zed#
Onde: settings.json do Zed
Adicione o servidor em context_servers.
{
"context_servers": {
"piqline": {
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Fonte: zed.dev, lida em 20 nov. 2026 (bloco da documentação oficial). Ainda não testado aqui com uma chave real.
Cline#
Onde: cline_mcp_settings.json
O campo type é obrigatório: sem ele, o Cline recorre ao SSE legado.
{
"mcpServers": {
"piqline": {
"type": "streamableHttp",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Fonte: docs.cline.bot, lida em 20 nov. 2026 (bloco da documentação oficial). Ainda não testado aqui com uma chave real.
Roo Code#
Onde: .roo/mcp.json
Adicione o servidor ao arquivo do projeto.
{
"mcpServers": {
"piqline": {
"type": "streamable-http",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Fonte: roocodeinc.github.io, lida em 20 nov. 2026 (bloco da documentação oficial). Ainda não testado aqui com uma chave real.
Continue#
Onde: config.yaml do Continue
A chave fica nos segredos do 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, lida em 20 nov. 2026 (montado a partir da documentação oficial). Ainda não testado aqui com uma chave real.
Windsurf#
Onde: ~/.codeium/windsurf/mcp_config.json
O Windsurf aceita o transporte HTTP e cabeçalhos. Se a sua versão rejeitar este bloco, use o relay mcp-remote abaixo.
{
"mcpServers": {
"piqline": {
"serverUrl": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Fonte: docs.devin.ai, lida em 20 nov. 2026 (cabeçalhos não documentados, relay recomendado). Ainda não testado aqui com uma chave real.
JetBrains AI Assistant#
Onde: Configurações › Tools › AI Assistant › Model Context Protocol
A documentação não mostra nenhum cabeçalho para um servidor remoto: use o relay mcp-remote abaixo.
Veja o relay mcp-remote.
Fonte: www.jetbrains.com, lida em 20 nov. 2026 (cabeçalhos não documentados, relay recomendado). Ainda não testado aqui com uma chave real.
Goose#
Onde: goose configure › Add extension › Remote
Adicione uma extensão HTTP remota com a URL do servidor e o cabeçalho Authorization. Caso contrário, use o relay mcp-remote abaixo.
https://piqline.com/api/mcpFonte: goose-docs.ai, lida em 20 nov. 2026 (cabeçalhos não documentados, relay recomendado). Ainda não testado aqui com uma chave real.
APIs e frameworks de agentes#
Claude API (Messages)#
Onde: Requisição da Messages API
O conector MCP da API chama o Piqline em nome do modelo. A chave vai em authorization_token. Veja a página da fonte para o cabeçalho beta atual.
{
"mcp_servers": [
{ "type": "url", "url": "https://piqline.com/api/mcp", "name": "piqline", "authorization_token": "piq_live_…" }
]
}Fonte: platform.claude.com, lida em 20 nov. 2026 (bloco da documentação oficial). Ainda não testado aqui com uma chave real.
OpenAI Responses API#
Onde: Ferramenta mcp de uma requisição Responses
A chave vai em 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, lida em 20 nov. 2026 (bloco da documentação oficial). Ainda não testado aqui com uma chave real.
OpenAI Agents SDK#
Onde: Python
Um servidor Streamable HTTP com o cabeçalho.
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, lida em 20 nov. 2026 (bloco da documentação oficial). Testado com uma chave real em 2026-11-20.
Vercel AI SDK#
Onde: TypeScript
O cliente MCP entrega as ferramentas a generateText ou 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, lida em 20 nov. 2026 (bloco da documentação oficial). Testado com uma chave real em 2026-11-20.
LangChain / LangGraph#
Onde: Python
As ferramentas do Piqline se tornam ferramentas do 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, lida em 20 nov. 2026 (bloco da documentação oficial). Testado com uma chave real em 2026-11-20.
Google ADK#
Onde: Python
Um toolset MCP para um 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, lida em 20 nov. 2026 (montado a partir da documentação oficial). Ainda não testado aqui com uma chave real.
n8n#
Onde: Nó “MCP Client Tool” de um agente de IA
Cole a URL do servidor, escolha o transporte HTTP e a autenticação “Bearer” e depois cole a sua chave.
https://piqline.com/api/mcpFonte: docs.n8n.io, lida em 20 nov. 2026 (montado a partir da documentação oficial). Ainda não testado aqui com uma chave real.
CrewAI#
Onde: Python
O CrewAI se conecta por Streamable HTTP; a documentação dele não mostra nenhum cabeçalho. Use o relay mcp-remote ou o LangChain.
Veja o relay mcp-remote.
Fonte: docs.crewai.com, lida em 20 nov. 2026 (cabeçalhos não documentados, relay recomendado). Ainda não testado aqui com uma chave real.
LlamaIndex#
Onde: Python
O LlamaIndex se conecta a um servidor HTTP; a documentação dele não mostra nenhum cabeçalho. Use o relay mcp-remote.
Veja o relay mcp-remote.
Fonte: developers.llamaindex.ai, lida em 20 nov. 2026 (cabeçalhos não documentados, relay recomendado). Ainda não testado aqui com uma chave real.
Qualquer outro cliente#
mcp-remote (any local client)#
Onde: Arquivo de configuração MCP do seu cliente
Para um cliente que só fala com um processo local (stdio): mcp-remote faz o relay do servidor HTTP. O valor do cabeçalho fica em env, sem espaço nos argumentos (alguns clientes dividem nos espaços).
{
"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, lida em 20 nov. 2026 (montado a partir da documentação oficial). Testado com uma chave real em 2026-11-20.