Servidor MCP do Memberfy (Streamable HTTP)
POST/mcp
- Auth
- Requiere token
Endpoint do Model Context Protocol para o Claude, o ChatGPT, o Cursor e qualquer cliente MCP. Corpo e resposta são JSON-RPC 2.0 (`initialize`, `tools/list`, `tools/call`…), sem sessão. Exige `Authorization: Bearer` com o access token do OAuth (`/oauth/token`); sem ele, 401 com `WWW-Authenticate` apontando para `/.well-known/oauth-protected-resource/mcp`. O token está preso a uma comunidade e o assistente age com o papel atual de quem conectou: as ferramentas chamam as mesmas rotas da API, com as mesmas regras. Dinheiro (cupom, preço, saque, cancelamento) pede confirmação em duas chamadas. Limite de 120 chamadas de ferramenta por minuto por conexão. Nomes de ferramentas e argumentos são identificadores em inglês (`snake_case`, ex.: `create_course`, `sales_report`); títulos, resumos e mensagens saem no idioma do membro conectado (senão o da comunidade, senão en-US). Respostas podem trazer `next_steps` (até três próximas ações que o papel pode executar), e o servidor expõe prompts prontos (`prompts/list`) conforme o papel. `serverInfo.version` é `<versão do pacote>+<commit curto>` e muda a cada deploy. O resultado de `initialize` e o de `tools/list` trazem `_meta.memberfy` com `server_version`, `tools_fingerprint` (hash curto dos nomes e dos esquemas de entrada da lista que esta conexão recebe) e `tool_count`; as instruções do servidor terminam com uma linha que repete a versão da lista. Chamar uma ferramenta fora da lista da conexão devolve um erro de ferramenta (`isError`) pedindo para a pessoa abrir uma nova conversa ou reconectar o conector; se o nome é um dos antigos em português, a resposta traz `renamed_to` com o nome novo.
Cuerpo de la solicitud application/json
La especificación no declara los campos de este cuerpo (una subida multipart, por ejemplo). Consulta la guía del tema.
Respuestas
| Código | Descripción |
|---|---|
200 | Resposta JSON-RPC (fora do envelope da API). |
401 | Sem token, ou token inválido, vencido ou revogado. |
429 | Limite de requisições da conexão. |
Ejemplo con curl
curl -X POST "https://api.memberfy.net/mcp" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{}'