Saltar al contenido
grostifyConnectDocs

Referencia del servidor MCP

Referencia técnica del servidor MCP de cada integración. Transporte, autorización, la lista de tools, errores y límites.

En esta página

No necesitas esta página para publicar tu API. Es para equipos que quieren saber exactamente qué ven los clientes MCP, o conectar un cliente propio.

Endpoint

Texto
POST https://connect.grostify.com/t/{slug}/mcp
PropiedadValor
TransporteStreamable HTTP, sin estado. Un mensaje JSON-RPC 2.0 por POST, respondido como application/json.
No compatibleServer sent events, lotes y Mcp-Session-Id. GET y DELETE responden 405.
Versiones del protocolo2025-11-25, 2025-06-18 y 2025-03-26
CuerpoHasta 1 MB
DisponibilidadSolo integraciones publicadas con el dominio verificado. El resto responde 404.

Las notificaciones responden 202 sin cuerpo.

Autorización

El servidor sigue la especificación de autorización de MCP con OAuth 2.1. Una petición sin token responde 401 con:

HTTP
WWW-Authenticate: Bearer resource_metadata="https://connect.grostify.com/.well-known/oauth-protected-resource/t/acme/mcp", scope="mcp:tools"

Metadatos

DocumentoURL
Recurso protegido (RFC 9728)/.well-known/oauth-protected-resource/t/{slug}/mcp
Servidor de autorización (RFC 8414)/.well-known/oauth-authorization-server/t/{slug}

El issuer es https://connect.grostify.com/t/{slug}, con estos endpoints debajo: /oauth/authorize, /oauth/token, /oauth/revoke y /oauth/register.

Clientes

  • Client ID metadata documents de Claude, Claude Code y ChatGPT.
  • Registro dinámico de clientes (RFC 7591) para clientes públicos cuyo redirect es el callback de Claude o de ChatGPT, o una dirección local (localhost o 127.0.0.1).

Flujo

ParámetroValor
GrantAuthorization code con PKCE S256
resourceLa dirección MCP, exacta
Scopesmcp:tools (siempre) y offline_access
Autenticación del clientenone o private_key_jwt

Tokens

TokenDuración
Código de autorización60 segundos, un solo uso
Access token (JWT ES256)15 minutos
Refresh token30 días, se renueva en cada uso

Revocar un token en /oauth/revoke cierra la conexión entera.

Tools

tools/list devuelve, en una sola página y ordenadas por nombre, las tools habilitadas en el canal de la conexión.

JSON
{  "name": "acme_track_shipment",  "title": "Rastrear un envío",  "description": "Devuelve el estado de un envío por su número de seguimiento...",  "inputSchema": {    "type": "object",    "properties": {      "tracking_number": { "type": "string", "description": "Número de seguimiento, por ejemplo ACM4820193746." }    },    "required": ["tracking_number"],    "additionalProperties": false  },  "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true }}

listChanged es false. Un cliente ve los cambios en la siguiente conversación.

Errores

Los errores de la propia tool vuelven como un resultado con isError: true y un mensaje para el modelo. Los mensajes van en inglés:

SituaciónMensaje
Falta un argumentoMissing required argument "x".
Argumento desconocidoUnknown argument "x".
Tu API tardó demasiadoThe API did not answer in time.
Tu API respondió 401The API rejected the credential. The user must reconnect the account.
Tu API respondió 403The user has no permission for this in the company's system.
Tu API respondió 404Not found. API said: ...
Tu API respondió 429The API is rate limiting. Try again later.
Tu API respondió 5xxThe API failed. Try again later.
Límite de la conexiónToo many requests for this connection. Wait a minute and try again.
La sesión en tu sistema caducóThe connection to Acme expired. Reconnect the connector.

Una tool que no existe o no está habilitada responde el error JSON-RPC -32602 Unknown tool.

Límites de uso

ÁmbitoLímite
Peticiones por conexión300 por minuto y 10.000 al día
Peticiones por integración3.000 por minuto
Peticiones sin un token válido, por IP60 por minuto

Cuentan todas las peticiones MCP autenticadas, no solo las llamadas a tools: también initialize, tools/list y las notificaciones.