Saltar al contenido

Guías

Servidor MCP

Los servidores MCP de Piqline, sus herramientas, las herramientas ask_<agent> y las anotaciones.

El servidor MCP expone las mismas herramientas que la API, más una herramienta por agente. Usa el transporte "Streamable HTTP", sin sesiones: cada petición es independiente. La clave se envía igual que en la API, en la cabecera Authorization.

Los servidores#

ServidorURLContenido
Todas las herramientashttps://piqline.com/api/mcptodas las herramientas que la clave puede llamar, y ask_<agent> para cada agente
Un agentehttps://piqline.com/api/mcp/{agent}las herramientas de ese agente y su ask_<agent>

{agent} es piqline, requete, facebook, linkedin, upwork u onboarding. El servidor de un solo agente conviene a los clientes que limitan el número de herramientas.

tools/list solo muestra las herramientas que la clave puede llamar: si falta una herramienta, es porque exige un scope que la clave no tiene. Las herramientas ask_<agent> exigen el scope agents, y ask_onboarding un rol de propietario o administrador.

Conectar un cliente#

Cada cliente tiene su bloque para copiar, contrastado con su documentación oficial, en Conectar tu cliente: Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Zed, Cline, Mistral Le Chat, Copilot Studio, n8n, LangChain, el SDK de Vercel y un relé para cualquier cliente local. Por ejemplo, en Claude Code:

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

Las herramientas ask_<agent>#

ask_piqline, ask_requete, ask_facebook, ask_linkedin, ask_upwork y ask_onboarding entregan una petición completa al agente correspondiente, igual que POST/api/v1/agents/{agent}.

ArgumentoFunción
messageLa petición, en lenguaje natural (obligatorio).
historyIntercambios anteriores con este agente, del más antiguo al más reciente: objetos { "role": "user" or "assistant", "text": "…" }.

La respuesta contiene el texto del agente. Cuando el agente se detiene por una pregunta o por una acción que confirmar, la respuesta lo indica y nombra la herramienta que hay que llamar.

Anotaciones#

Cada herramienta declara readOnlyHint, destructiveHint y openWorldHint. Un cliente puede usarlas para pedir confirmación antes de las herramientas que escriben, borran o leen en directo.

Errores#

Una herramienta que falla responde con isError: true y un mensaje legible. Los rechazos que llegan antes de la herramienta (clave, scope, límite) son respuestas HTTP 401, 403 o 429 en application/problem+json, descritas en Errores. Ambos casos aparecen en el historial de peticiones de Ajustes → API y MCP.

Inicio de sesión con una cuenta#

ChatGPT solo acepta inicio de sesión con OAuth o ninguna autenticación: hoy se conecta a la puerta abierta, https://piqline.com/api/open/mcp. El inicio de sesión con una cuenta de Piqline (OAuth) está en preparación; todos los demás clientes de la página Conectar tu cliente aceptan la clave.

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