# Servidor MCP

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

Source: https://piqline.com/es/docs/api/mcp

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](/es/docs/api/clients): 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:

```bash
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}`](/es/docs/api/agents).

| 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](/es/docs/api/errors). 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](/es/docs/api/clients) aceptan la clave.
