MCP

Clauhub tiene un servidor MCP (Model Context Protocol) para que un asistente de IA trabaje con tu cuenta: lo que la API ofrece a las personas, el servidor lo ofrece como herramientas.

La dirección

https://clauhub.ai/api/mcp

Es un servidor MCP por HTTP (streamable HTTP). Lo agregas a tu cliente con la dirección y nada más.

Cómo te conectas

Con OAuth (lo normal). El cliente intenta conectarse, recibe un 401 y encuentra solo dónde iniciar sesión:

1. Lee /.well-known/oauth-protected-resource/api/mcp, que le dice cuál es el servidor de autorización de Clauhub.
2. Se identifica, registrándose solo (registro dinámico de clientes) o con un documento de metadatos (su client_id es la URL https de ese documento).
3. Te manda a iniciar sesión en Clauhub y a una página de consentimiento que nombra a la app. Si aceptas, la app recibe un token; si no, no se conecta.

El flujo es OAuth 2.1 con PKCE (S256). El token actúa como tú, con tus permisos.

Con una llave de API. Si tu cliente te deja poner encabezados, manda tu llave de API como authorization: Bearer ch_...; funciona igual que x-api-key.

Las herramientas

Cada procedimiento que una persona puede llamar en la API es una herramienta, con el nombre <dominio>_<grupo>_<procedimiento>; por ejemplo, identity_organizations_list responde tus organizaciones. Cada herramienta trae su descripción y el JSON Schema de su entrada.

Una llamada a una herramienta es la misma llamada a la API, hecha como tú: cada servicio decide igual que siempre. Si te falta un permiso o la entrada no es válida, la herramienta responde un error (isError) con el error de la API, como PERMISSION_DENIED o BAD_REQUEST.

Guías por cliente

Cómo agregarlo en cada asistente de IA, paso a paso: Próximamente.