Cómo conectarse a un servidor MCP mediante JSON-RPC

Enviar solicitudes MCP autenticadas a un servidor de cuenta.

Requisitos previos

• Servidor habilitado.
• Endpoint y slug.
• OAuth Bearer o token estático.

Permisos y disponibilidad

La interfaz utilizada para esta documentación fue observada con un usuario Administrador. La configuración de integraciones, importaciones, servidores MCP y credenciales requiere permisos administrativos. El acceso mediante API depende del tipo de token y del alcance autorizado para la solicitud.

Ruta de acceso

Servidor MCP de Waclis Inbox

Procedimiento

1. Construye el endpoint de cuenta y servidor.
2. Selecciona un único método de autenticación.
3. Envía una solicitud JSON-RPC 2.0.
4. Inicializa la sesión según el cliente.
5. Consulta las herramientas.
6. Ejecuta una operación permitida.
7. Registra errores sin guardar secretos.

Ejemplos

Solicitud JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

Solicitud con OAuth

curl --request POST \
  --url '{{base_url}}/mcp/{{account_id}}/{{server_slug}}' \
  --header 'Authorization: Bearer {{oauth_token}}' \
  --header 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Resultado esperado

Puedes aplicar la configuración o solicitud con parámetros y credenciales controlados.

Consideraciones importantes

• La versión admite OAuth con registro, autorización, token, refresh token y PKCE.
• También admite autenticación estática mediante Api-Access-Token.

Artículos relacionados

• Cómo probar un servidor MCP
• Referencia de servidores MCP, endpoint y autenticación
• Guía de autenticación para la API de Waclis Inbox
• Referencia de códigos de respuesta y errores de API