Saltar al contenido

Guías

Conectar tu cliente

Conecta Piqline desde Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Zed, Mistral Le Chat, Copilot Studio, n8n, LangChain, el SDK de Vercel y cualquier otro cliente MCP: un bloque para copiar por cliente.

Piqline tiene dos servidores MCP, ambos sobre Streamable HTTP:

ServidorURLAutenticación
Completohttps://piqline.com/api/mcpClave de API en la cabecera Authorization: Bearer …
Puerta abiertahttps://piqline.com/api/open/mcpninguna: lo que Piqline sabe hacer y sus datos públicos

Crea la clave en una cuenta gratuita, en Ajustes → API y MCP. Guárdala en una variable de entorno PIQLINE_API_KEY en lugar de en un archivo compartido.

ClienteProveedorClave en una cabecera
Claude (claude.ai, Claude Desktop)Anthropicsí
ChatGPTOpenAIno, solo puerta abierta
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í
WindsurfCognitionmediante el relé
JetBrains AI AssistantJetBrainsmediante el relé
GooseBlockmediante el relé
Claude API (Messages)Anthropicsí
OpenAI Responses APIOpenAIsí
OpenAI Agents SDKOpenAIsí
Vercel AI SDKVercelsí
LangChain / LangGraphLangChainsí
Google ADKGooglesí
n8nn8nsí
CrewAICrewAImediante el relé
LlamaIndexLlamaIndexmediante el relé
mcp-remote (any local client)Open sourcesí

Asistentes y aplicaciones#

Claude (claude.ai, Claude Desktop)#

Dónde: Ajustes › Conectores › Añadir conector personalizado

Pega la URL del servidor y, en «Request headers», añade Authorization con el valor Bearer seguido de tu clave. Sin clave, la URL de la puerta abierta funciona con «No sign in».

https://piqline.com/api/mcp

En los planes Team y Enterprise, una cabecera definida en el conector la comparten todos los miembros: crea una clave dedicada y con tope.

Fuente: support.claude.com, consultada el 20 nov 2026 (bloque de la documentación oficial). Aún no probado aquí con una clave real.

ChatGPT#

Dónde: Ajustes › Apps › Modo desarrollador › Crear

ChatGPT no acepta una clave en una cabecera: solo OAuth o ninguna autenticación. Conecta hoy la puerta abierta, sin clave; el servidor completo llegará con el inicio de sesión mediante una cuenta de Piqline.

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

Fuente: developers.openai.com, consultada el 20 nov 2026 (bloque de la documentación oficial). Aún no probado aquí con una clave real.

Mistral Le Chat#

Dónde: Conectores › Añadir conector MCP (admin)

Pega la URL del servidor, elige la autenticación con token Bearer y pega tu clave.

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

Fuente: docs.mistral.ai, consultada el 20 nov 2026 (montado a partir de la documentación oficial). Aún no probado aquí con una clave real.

Microsoft Copilot Studio#

Dónde: Agente › Herramientas › Añadir una herramienta › Nueva herramienta › Model Context Protocol

Pega la URL del servidor, elige «Clave de API», ubicación «Header» y nombre Authorization. Al conectar, introduce Bearer seguido de tu clave.

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

Fuente: learn.microsoft.com, consultada el 20 nov 2026 (montado a partir de la documentación oficial). Aún no probado aquí con una clave real.

Agentes de programación y editores#

Claude Code#

Dónde: Terminal

Un solo comando. Añade --scope project para escribirlo en .mcp.json y compartirlo con el equipo.

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

Fuente: code.claude.com, consultada el 20 nov 2026 (bloque de la documentación oficial). Probado con una clave real el 2026-11-20.

Codex CLI#

Dónde: ~/.codex/config.toml

Codex lee la clave de una variable de entorno: exporta PIQLINE_API_KEY y añade el servidor a la configuración.

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

Fuente: learn.chatgpt.com, consultada el 20 nov 2026 (bloque de la documentación oficial). Aún no probado aquí con una clave real.

Gemini CLI#

Dónde: Terminal o ~/.gemini/settings.json

Un solo comando, o el bloque en settings.json. La clave httpUrl selecciona el transporte HTTP (url indicaría el SSE heredado).

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

Fuente: geminicli.com, consultada el 20 nov 2026 (bloque de la documentación oficial). Probado con una clave real el 2026-11-20.

Cursor#

Dónde: ~/.cursor/mcp.json o .cursor/mcp.json

El bloque lee la clave de una variable de entorno.

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

Fuente: cursor.com, consultada el 20 nov 2026 (bloque de la documentación oficial). Aún no probado aquí con una clave real.

VS Code (GitHub Copilot)#

Dónde: .vscode/mcp.json

VS Code pide la clave en la primera conexión y la guarda en su almacén de secretos. Está anunciado que el formato de .vscode/mcp.json será sustituido en febrero de 2027 por un .mcp.json en la raíz, con el formato de 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}" }
    }
  }
}

Fuente: code.visualstudio.com, consultada el 20 nov 2026 (montado a partir de la documentación oficial). Aún no probado aquí con una clave real.

Zed#

Dónde: settings.json de Zed

Añade el servidor en context_servers.

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

Fuente: zed.dev, consultada el 20 nov 2026 (bloque de la documentación oficial). Aún no probado aquí con una clave real.

Cline#

Dónde: cline_mcp_settings.json

El campo type es obligatorio: sin él, Cline recurre al SSE heredado.

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

Fuente: docs.cline.bot, consultada el 20 nov 2026 (bloque de la documentación oficial). Aún no probado aquí con una clave real.

Roo Code#

Dónde: .roo/mcp.json

Añade el servidor al archivo del proyecto.

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

Fuente: roocodeinc.github.io, consultada el 20 nov 2026 (bloque de la documentación oficial). Aún no probado aquí con una clave real.

Continue#

Dónde: config.yaml de Continue

La clave permanece en los secretos de Continue.

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

Fuente: docs.continue.dev, consultada el 20 nov 2026 (montado a partir de la documentación oficial). Aún no probado aquí con una clave real.

Windsurf#

Dónde: ~/.codeium/windsurf/mcp_config.json

Windsurf acepta el transporte HTTP y las cabeceras. Si tu versión rechaza este bloque, usa el relé mcp-remote que se describe más abajo.

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

Fuente: docs.devin.ai, consultada el 20 nov 2026 (cabeceras sin documentar, se recomienda el relé). Aún no probado aquí con una clave real.

JetBrains AI Assistant#

Dónde: Ajustes › Herramientas › AI Assistant › Model Context Protocol

La documentación no muestra ninguna cabecera para un servidor remoto: usa el relé mcp-remote que se describe más abajo.

Consulta el relé mcp-remote.

Fuente: www.jetbrains.com, consultada el 20 nov 2026 (cabeceras sin documentar, se recomienda el relé). Aún no probado aquí con una clave real.

Goose#

Dónde: goose configure › Add extension › Remote

Añade una extensión HTTP remota con la URL del servidor y la cabecera Authorization. Si no, usa el relé mcp-remote que se describe más abajo.

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

Fuente: goose-docs.ai, consultada el 20 nov 2026 (cabeceras sin documentar, se recomienda el relé). Aún no probado aquí con una clave real.

APIs y frameworks de agentes#

Claude API (Messages)#

Dónde: Petición a la Messages API

El conector MCP de la API llama a Piqline en nombre del modelo. La clave va en authorization_token. Consulta la página de la fuente para ver la cabecera beta vigente.

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

Fuente: platform.claude.com, consultada el 20 nov 2026 (bloque de la documentación oficial). Aún no probado aquí con una clave real.

OpenAI Responses API#

Dónde: Herramienta mcp de una petición Responses

La clave va en headers.

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

Fuente: developers.openai.com, consultada el 20 nov 2026 (bloque de la documentación oficial). Aún no probado aquí con una clave real.

OpenAI Agents SDK#

Dónde: Python

Un servidor Streamable HTTP con la cabecera.

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

Fuente: openai.github.io, consultada el 20 nov 2026 (bloque de la documentación oficial). Probado con una clave real el 2026-11-20.

Vercel AI SDK#

Dónde: TypeScript

El cliente MCP entrega las herramientas 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();

Fuente: ai-sdk.dev, consultada el 20 nov 2026 (bloque de la documentación oficial). Probado con una clave real el 2026-11-20.

LangChain / LangGraph#

Dónde: Python

Las herramientas de Piqline se convierten en herramientas de 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()

Fuente: github.com, consultada el 20 nov 2026 (bloque de la documentación oficial). Probado con una clave real el 2026-11-20.

Google ADK#

Dónde: Python

Un toolset MCP para un agente de 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']}"},
))

Fuente: adk.dev, consultada el 20 nov 2026 (montado a partir de la documentación oficial). Aún no probado aquí con una clave real.

n8n#

Dónde: Nodo «MCP Client Tool» de un agente de IA

Pega la URL del servidor, elige el transporte HTTP y la autenticación «Bearer», y pega tu clave.

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

Fuente: docs.n8n.io, consultada el 20 nov 2026 (montado a partir de la documentación oficial). Aún no probado aquí con una clave real.

CrewAI#

Dónde: Python

CrewAI se conecta por Streamable HTTP; su documentación no muestra ninguna cabecera. Usa el relé mcp-remote o LangChain.

Consulta el relé mcp-remote.

Fuente: docs.crewai.com, consultada el 20 nov 2026 (cabeceras sin documentar, se recomienda el relé). Aún no probado aquí con una clave real.

LlamaIndex#

Dónde: Python

LlamaIndex se conecta a un servidor HTTP; su documentación no muestra ninguna cabecera. Usa el relé mcp-remote.

Consulta el relé mcp-remote.

Fuente: developers.llamaindex.ai, consultada el 20 nov 2026 (cabeceras sin documentar, se recomienda el relé). Aún no probado aquí con una clave real.

Cualquier otro cliente#

mcp-remote (any local client)#

Dónde: El archivo de configuración MCP de tu cliente

Para un cliente que solo habla con un proceso local (stdio): mcp-remote retransmite el servidor HTTP. El valor de la cabecera va en env, sin espacios en los argumentos (algunos clientes dividen por espacios).

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

Fuente: github.com, consultada el 20 nov 2026 (montado a partir de la documentación oficial). Probado con una clave real el 2026-11-20.

¿Tienes una pregunta sobre la API o has encontrado un error en esta página? Escríbenos.