Compatibilidad de clientes

Compatibilidad de clientes MCP

Snippets de configuración listos para los clientes MCP más comunes. El endpoint es la tienda demo pública; reemplázalo por tu slug en producción.

Patrones de integración por bucket

Cada cliente típico elige el bucket MCP según el scope de la operación. Discovery (anonymous) → Customer (OAuth) → Checkout (AgenticTrust + idempotency).

Cliente	Bucket recomendado	Por qué
Claude.ai agent	discovery → customer → checkout	Empieza en Discovery (sin login). Si el usuario inicia sesión vía Custom Connector, escala a Customer. Checkout requiere mandate firmado por el principal.
KYApay (agent payment service)	checkout	Solo opera tools transaccionales con AgenticTrust + Idempotency-Key. No necesita Discovery ni Customer scope.
ChatGPT Custom GPT	discovery (vía OpenAPI Action)	ChatGPT no implementa transporte MCP. Mapeamos Discovery a una OpenAPI Action; Customer/Checkout no se exponen vía GPTs.
Agente custom (SDK propio)	según scope	Detecta capabilities vía /.well-known/mcp.json. Cada bucket publica su propio descriptor + JWKS independiente.

Legacy /{storeSlug}/mcp deprecated — sunset vía MCP_LEGACY_SUNSET. Guía de migración.

Claude Desktop

Transporte: MCP Streamable HTTP
Autenticación: Flujo OAuth 2.1 web al primer uso (discovery vía /.well-known/oauth-protected-resource).

Configuración — claude_desktop_config.json

{
  "mcpServers": {
    "trusteed": {
      "url": "https://trusteed.xyz/demo-store/mcp",
      "transport": "streamable-http"
    }
  }
}

Documentación oficial del cliente →

Claude.ai (Custom Connectors)

Transporte: MCP Streamable HTTP
Autenticación: OAuth en navegador integrado en Claude.ai al añadir el conector.

Configuración — Ajustes → Conectores → Añadir conector personalizado

URL: https://trusteed.xyz/demo-store/mcp
Nombre: Trusteed
(OAuth lo gestiona Claude.ai)

Documentación oficial del cliente →

ChatGPT / GPT Builder

Transporte: OpenAPI Action
Autenticación: API key (cabecera X-Agent-Api-Key) — ChatGPT NO implementa transporte MCP.

Limitaciones

El transporte MCP no está soportado en GPTs personalizados. Usa la REST API vía OpenAPI Action; el build chatgpt-app PostMessage corre en agenticmcpstores-production.up.railway.app y solo sirve para ChatGPT Apps SDK, no para Claude.ai.

Configuración — GPT Builder → Actions → Import OpenAPI

URL OpenAPI: https://api.trusteed.xyz/api/v1/openapi.json
Auth: API key, cabecera personalizada "X-Agent-Api-Key"

Documentación oficial del cliente →

Cursor

Transporte: MCP Streamable HTTP
Autenticación: OAuth 2.1 lanzado desde Cursor en la primera tool.

Configuración — ~/.cursor/mcp.json

{
  "mcpServers": {
    "trusteed": {
      "url": "https://trusteed.xyz/demo-store/mcp",
      "type": "http"
    }
  }
}

Documentación oficial del cliente →

Continue.dev

Transporte: MCP Streamable HTTP
Autenticación: OAuth 2.1 (flujo web en primera llamada).

Configuración — ~/.continue/config.json

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": { "type": "streamable-http", "url": "https://trusteed.xyz/demo-store/mcp" }
      }
    ]
  }
}

Documentación oficial del cliente →