Saltar al contenido

Servidor MCP do Memberfy (Streamable HTTP)

POST/mcp

Auth
Requiere token
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

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ódigoDescripción
200Resposta JSON-RPC (fora do envelope da API).
401Sem token, ou token inválido, vencido ou revogado.
429Limite 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 '{}'