Kit LLM

FastComments executa um servidor hospedado do Model Context Protocol (MCP) para que assistentes de IA e clientes agentes possam chamar a API do FastComments diretamente. Cada ferramenta que o servidor MCP expõe é gerada automaticamente a partir da especificação OpenAPI pública, portanto tudo o que a API REST pode fazer, um cliente MCP pode fazer.

O endpoint é sem estado e baseado em HTTP transmissível. Não há sessão para manter ativa e nenhum estado no servidor por cliente.

Endpoint

Endpoint MCP

Copy

1

2https://fastcomments.com/mcp

3

Conectar com OAuth

Qualquer cliente MCP que suporte servidores remotos com OAuth (Claude, ChatGPT, Claude Code, Cursor e outros) pode conectar ao endpoint acima sem configuração no lado do FastComments. O cliente registra-se através do Registro Dinâmico de Cliente ou identifica-se com um Documento de Metadados de ID de Cliente, abre um navegador para que você possa fazer login no FastComments e aprovar o acesso, e recebe um token vinculado à conta na qual você estava conectado.

Os documentos de descoberta estão nos locais padrão:

Descoberta

Copy

1

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

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

4

Seu usuário precisa da permissão de Administrador de API na conta para aprovar uma conexão. Se você gerencia várias contas, troque para a correta no painel antes de aprovar.

Um cliente pode solicitar o escopo read, o escopo write ou ambos. Um cliente que não solicita nada recebe ambos. Ferramentas que alteram dados não são oferecidas a um token somente de leitura.

O painel possui um assistente de configuração com trechos prontos para colar. Abra Integrar -> Servidor MCP, ou acesse diretamente:

Página de Configuração

Copy

1

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

3

Claude Code

Registre o servidor FastComments com um único comando, então execute /mcp dentro de uma sessão para fazer login e listar as ferramentas disponíveis:

Configuração Claude Code

Copy

1

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

3

Cursor e outros clientes de arquivo de configuração

Adicione este bloco à configuração de servidores MCP do seu cliente (mcp.json para Cursor). O cliente abre um navegador para fazer login na primeira utilização.

Configuração do Cliente MCP

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

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

7 }

8 }

9}

10

Revogando acesso

Toda conexão aprovada é listada em Integrar -> Aplicativos Conectados no painel. Revogar uma invalida todos os tokens que a aplicação possui. As aplicações se registram ao conectar e o FastComments não as revisa, portanto revogue tudo o que você não reconheça.

Usando o token com a API REST

O token de acesso que um cliente MCP obtém é uma credencial regular da API FastComments. Ele funciona em todos os endpoints /api/v1 como um token bearer, portanto uma aplicação que se conectou via MCP também pode chamar a API REST diretamente:

Token Bearer

Copy

1

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

3

O locatário (tenant) é implícito pelo token. Um tenantId ainda pode ser passado, mas deve coincidir. Requisições GET precisam do escopo read e todo o resto precisa do escopo write.

Conectar com uma chave de API

Clientes que não podem concluir um login via navegador, como servidores sem interface, podem autenticar-se com uma chave de API. Passe tenantId e API_KEY como parâmetros de consulta, ou como os cabeçalhos HTTP x-tenant-id e x-api-key se seu cliente suportar cabeçalhos personalizados:

Endpoint de Chave de API

Copy

1

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

3

A página de configuração gera esta URL para cada uma de suas chaves de API.

Segurança

Uma URL de endpoint que contém uma chave de API é um segredo: não cole‑a em chats públicos, capturas de tela ou commits. Se uma chave for exposta, rotacione‑a na página de Chaves de API no seu painel. Tokens OAuth não apresentam esse risco porque são vinculados a uma única aplicação e podem ser revogados em Aplicativos Conectados.

A coding agent such as Claude Code, Cursor, or an MCP-based assistant can set up FastComments for you without you filling in the signup form. This is useful when you ask an agent to "add comments to my site" and you do not have an account yet.

Como funciona

1. O agente cria uma nova conta e recebe uma chave de API e um link de reivindicação. A chave de API funciona imediatamente, permitindo que o agente configure a conta e instale o widget em seu site.
2. O agente lhe fornece o link de reivindicação. Abra‑o em seu navegador, faça login ou crie um login, e confirme a reivindicação. A conta então será sua: você a gerencia, sua cobrança e suas chaves de API a partir do painel. A página lista a chave de API que o agente possui, para que você possa revogá‑la se não quiser mais que o agente, ou quem quer que o execute, tenha acesso.
3. Se ninguém abrir o link de reivindicação dentro de 72 horas, a conta e sua chave são excluídas. Peça ao agente que crie uma nova.

Até que seja reivindicada, a conta tem os mesmos limites de um teste gratuito normal.

Se você já tem uma conta

Cada login possui uma conta. Se você abrir um link de reivindicação enquanto estiver conectado a uma conta existente, a página permite que você escolha:

• Anexar à minha conta torna a nova conta um inquilino gerenciado da conta na qual você está conectado. Isso requer um plano pago com marca branca, e o uso do novo inquilino é cobrado na sua conta.
• Sair e reivindicar com outro login desconecta você e o leva de volta à página de reivindicação para que possa reivindicá‑la com um login diferente.

Para autores de agentes

As instruções para agentes em fastcomments.com/agents.md descrevem a chamada de criação de conta, os campos na resposta e como entregar o link de reivindicação à pessoa para quem você está trabalhando. A chamada não requer chave de API e tem limite de taxa por endereço IP.