Ir para o conteúdo

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:

ServidorURLAutenticação
Completohttps://piqline.com/api/mcpchave de API no cabeçalho Authorization: Bearer …
Porta abertahttps://piqline.com/api/open/mcpnenhuma: 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.

ClienteFornecedorChave em um cabeçalho
Claude (claude.ai, Claude Desktop)Anthropicsim
ChatGPTOpenAInão, somente porta aberta
Mistral Le ChatMistral AIsim
Microsoft Copilot StudioMicrosoftsim
Claude CodeAnthropicsim
Codex CLIOpenAIsim
Gemini CLIGooglesim
CursorAnyspheresim
VS Code (GitHub Copilot)Microsoftsim
ZedZed Industriessim
ClineClinesim
Roo CodeRoo Codesim
ContinueContinuesim
WindsurfCognitionpelo relay
JetBrains AI AssistantJetBrainspelo relay
GooseBlockpelo relay
Claude API (Messages)Anthropicsim
OpenAI Responses APIOpenAIsim
OpenAI Agents SDKOpenAIsim
Vercel AI SDKVercelsim
LangChain / LangGraphLangChainsim
Google ADKGooglesim
n8nn8nsim
CrewAICrewAIpelo relay
LlamaIndexLlamaIndexpelo relay
mcp-remote (any local client)Open sourcesim

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

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.

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

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

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

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

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

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

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.

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

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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, lida em 20 nov. 2026 (montado a partir da documentação oficial). Testado com uma chave real em 2026-11-20.

Uma dúvida sobre a API, ou um erro nesta página? Escreva para nós.