Conecta un cliente MCP y deja que el agente se cotice a sí mismo

Un endpoint, Streamable HTTP

El servidor habla JSON-RPC 2.0 sobre Streamable HTTP en un único endpoint. Llama a tools/list para descubrir las herramientas que tu token alcanza realmente, en vez de fiarte de una lista copiada de una página como esta.

# JSON-RPC 2.0 over Streamable HTTP, one endpoint.
curl -X POST https://api.qannasapi.com/mcp \
  -H "Authorization: Bearer $QANNAS_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

# Trust this over any tool list copied from a page — it reflects
# the scopes your token actually carries.

Crea un token con alcance limitado

Los tokens se muestran una sola vez al crearlos y llevan alcances de solo lectura, denegando por defecto. No hay alcance de escritura que retener: un token puede consultar y nunca puede cambiar, enviar ni borrar nada. La revocación es inmediata.

// Any client with a custom-headers field connects today.
{
  "mcpServers": {
    "qannas": {
      "url": "https://api.qannasapi.com/mcp",
      "headers": {
        "Authorization": "Bearer qm_…"
      }
    }
  }
}

// The token is shown once at creation. Store it then.

Haz que el agente cotice primero

Las herramientas de flujo aceptan una cotización dry_run, y pedirla no cuesta nada. Pon la instrucción en el prompt de sistema — cotiza primero y espera aprobación — para que el agente proponga un coste antes de gastar nada.

# Put this in the agent's system prompt.
# A dry_run quote is free, so there is no reason not to.

Before running any QannasAPI workflow tool, call it once with
dry_run: true, show me the credit quote, and wait for my
approval before running it for real.

Ten claro qué no lleva MCP

El seguimiento por delta es solo de REST: since_cursor y track_delta no se exponen por MCP. Las búsquedas de contacto por consenso también son solo de REST. Y las llamadas por MCP siempre cobran créditos reales — no hay modo de clave de prueba en esta superficie.

Resumen

Lista para producción

• Llama a tools/list con tu propio token en vez de fijar una lista de herramientas en el código.
• Pon «cotiza primero, espera aprobación» en el prompt de sistema del agente.
• Crea un token por agente para que revocar uno no moleste al resto.
• Guarda el token al crearlo — no se vuelve a mostrar nunca.

Siguientes pasos