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#
| Servidor | URL | Contenido |
|---|---|---|
| Todas las herramientas | https://piqline.com/api/mcp | todas las herramientas que la clave puede llamar, y ask_<agent> para cada agente |
| Un agente | https://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:
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}.
| Argumento | Función |
|---|---|
message | La petición, en lenguaje natural (obligatorio). |
history | Intercambios 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.