Kit LLM

FastComments ejecuta un servidor Model Context Protocol (MCP) alojado para que los asistentes de IA y los clientes agentes puedan llamar directamente a la API de FastComments. Cada herramienta que expone el servidor MCP se genera automáticamente a partir de la especificación OpenAPI pública, por lo que todo lo que la API REST puede hacer, un cliente MCP puede hacerlo.

El endpoint es sin estado y basado en HTTP transmisible. No hay una sesión que mantener activa y no hay estado del lado del servidor por cliente.

Endpoint

Endpoint MCP

Copy

1

2https://fastcomments.com/mcp

3

Conectar con OAuth

Cualquier cliente MCP que admita servidores remotos con OAuth (Claude, ChatGPT, Claude Code, Cursor y otros) puede conectarse al endpoint anterior sin configuración en FastComments. El cliente se registra a través del Registro Dinámico de Clientes o se identifica con un Documento de Metadatos de ID de Cliente, abre un navegador para que puedas iniciar sesión en FastComments y aprobar el acceso, y recibe un token vinculado a la cuenta en la que iniciaste sesión.

Los documentos de descubrimiento están en las ubicaciones estándar:

Descubrimiento

Copy

1

2https://fastcomments.com/.well-known/oauth-protected-resource/mcp

3https://fastcomments.com/.well-known/oauth-authorization-server

4

Tu usuario necesita el permiso de Administrador de API en la cuenta para aprobar una conexión. Si gestionas varias cuentas, cambia a la correcta en el panel antes de aprobar.

Un cliente puede solicitar el alcance read, el alcance write, o ambos. Un cliente que no solicite nada obtiene ambos. Las herramientas que modifican datos no se ofrecen a un token de solo lectura.

El panel tiene un asistente de configuración con fragmentos listos para copiar. Abre Integrate -> MCP Server, o visítalo directamente:

Página de Configuración

Copy

1

2https://fastcomments.com/auth/my-account/mcp-setup

3

Claude Code

Registra el servidor FastComments con un solo comando, luego ejecuta /mcp dentro de una sesión para iniciar sesión y listar las herramientas disponibles:

Configuración Claude Code

Copy

1

2claude mcp add --transport http fastcomments https://fastcomments.com/mcp

3

Cursor y otros clientes de archivo de configuración

Añade este bloque a la configuración de servidores MCP de tu cliente (mcp.json para Cursor). El cliente abre un navegador para iniciar sesión en el primer uso.

Configuración del Cliente MCP

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

6 "url": "https://fastcomments.com/mcp"

7 }

8 }

9}

10

Revocar acceso

Cada conexión aprobada se lista bajo Integrate -> Connected Apps en el panel. Revocar una invalida todos los tokens que esa aplicación posee. Las aplicaciones se registran al conectarse y FastComments no las revisa, así que revoca cualquier cosa que no reconozcas.

Usar el token con la API REST

El token de acceso que obtiene un cliente MCP es una credencial normal de la API de FastComments. Funciona en cada endpoint /api/v1 como token bearer, por lo que una aplicación que se conectó a través de MCP también puede llamar directamente a la API REST:

Token Bearer

Copy

1

2curl -H "Authorization: Bearer fcat_..." https://fastcomments.com/api/v1/comments

3

El inquilino (tenant) está implícito en el token. Un tenantId aún puede enviarse pero debe coincidir. Las solicitudes GET necesitan el alcance read y todo lo demás necesita el alcance write.

Conectar con una clave API

Los clientes que no pueden completar un inicio de sesión en el navegador, como servidores sin cabeza, pueden autenticarse con una clave API en su lugar. Pasa tenantId y API_KEY como parámetros de consulta, o como los encabezados HTTP x-tenant-id y x-api-key si tu cliente admite encabezados personalizados:

Endpoint de Clave API

Copy

1

2https://fastcomments.com/mcp?tenantId=YOUR_TENANT_ID&API_KEY=YOUR_API_KEY

3

La página de configuración genera esta URL para cada una de tus claves API.

Seguridad

Una URL de endpoint que contiene una clave API es un secreto: no la pegues en chats públicos, capturas de pantalla o commits. Si una clave se expone, rótala en la página de Claves API en tu panel. Los tokens OAuth no conllevan ese riesgo porque están vinculados a una sola aplicación y pueden revocarse desde Connected Apps.

Un agente de codificación como Claude Code, Cursor o un asistente basado en MCP puede configurar FastComments para ti sin que tengas que rellenar el formulario de registro. Esto es útil cuando le pides a un agente que "añada comentarios a mi sitio" y aún no tienes una cuenta.

Cómo funciona

1. El agente crea una nueva cuenta y recibe una clave API y un enlace de reclamación. La clave API funciona de inmediato, por lo que el agente puede configurar la cuenta e instalar el widget en tu sitio.
2. El agente te entrega el enlace de reclamación. Ábrelo en tu navegador, inicia sesión o crea un inicio de sesión, y confirma la reclamación. Entonces la cuenta es tuya: la gestionas, su facturación y sus claves API desde el panel de control. La página muestra la clave API que posee el agente para que puedas revocarla si ya no deseas que el agente, o quien lo ejecute, tenga acceso.
3. Si nadie abre el enlace de reclamación dentro de las 72 horas, la cuenta y su clave se eliminan. Pide al agente que cree una nueva.

Hasta que se reclame, la cuenta tiene los mismos límites que una prueba gratuita normal.

Si ya tienes una cuenta

Cada inicio de sesión posee una cuenta. Si abres un enlace de reclamación mientras estás conectado a una cuenta existente, la página te permite elegir:

• Adjuntar a mi cuenta hace que la nueva cuenta sea un inquilino gestionado de la cuenta en la que has iniciado sesión. Esto requiere un plan de pago con marca blanca, y el uso del nuevo inquilino se factura a tu cuenta.
• Cerrar sesión y reclamar con otro inicio de sesión cierra tu sesión y te lleva de vuelta a la página de reclamación para que puedas reclamarla con un inicio de sesión diferente.

Para autores de agentes

Las instrucciones para agentes en fastcomments.com/agents.md describen la llamada de creación de cuenta, los campos en la respuesta y cómo entregar el enlace de reclamación a la persona para la que trabajas. La llamada no necesita una clave API y está limitada por tasa por dirección IP.