Conectar o Claude Code e o Cursor
Como adicionar o servidor MCP da Memberfy no Claude Code (pelo comando ou pelo .mcp.json) e no Cursor (pelo mcp.json), autorizar no navegador e conferir a conexão. Para quem trabalha no terminal ou no editor.
O Claude Code e o Cursor falam MCP por HTTP, como o Claude e o ChatGPT: basta apontar para https://api.memberfy.net/mcp. Na primeira chamada, eles abrem o navegador para você autorizar com a sua conta da Memberfy. Não existe chave para copiar nem segredo para guardar no projeto.
O endereço e estes passos também estão na própria Memberfy. Em Minha Conta › Assistentes de IA (
/account?tab=assistants), ou em Configurações › Assistentes de IA (proprietário e administrador), o bloco Conectar um assistente mostra o Endereço do servidor MCP com o botão Copiar, e os passos de cada assistente: Claude, ChatGPT e Claude Code / Cursor (com o comando e o trecho do arquivo, em Copiar o trecho).
Claude Code
Pelo comando
No terminal, na pasta do projeto:
claude mcp add --transport http memberfy https://api.memberfy.net/mcp
Para valer em todos os seus projetos, e não só neste, acrescente --scope user.
Pelo arquivo
Ou crie (ou edite) o .mcp.json na raiz do projeto:
{
"mcpServers": {
"memberfy": {
"type": "http",
"url": "https://api.memberfy.net/mcp"
}
}
}
O .mcp.json pode ir para o repositório: ele não tem nenhum segredo. Cada pessoa da equipe autoriza com a própria conta e o próprio papel.
Autorizar
- Abra o Claude Code e digite
/mcp. - Escolha memberfy e a opção de autenticar.
- O navegador abre a tela da Memberfy. Entre, escolha a comunidade e clique em Permitir.
- Volte ao terminal: o servidor aparece como conectado, com as ferramentas.
- Teste: "use a memberfy e me diga em que comunidade você está conectado".
Receitas prontas
No Claude Code, as oito receitas da Memberfy viram comandos: digite / e escolha, por exemplo, /mcp__memberfy__monthly_report (o relatório do mês) ou /mcp__memberfy__create_course. A lista e quem vê cada uma estão em Receitas prontas no menu. Uma sessão aberta antes de 6/10/2026 ainda pode mostrar os nomes antigos das ferramentas: abra uma sessão nova.
Cursor
- Abra Cursor Settings › MCP e adicione um servidor, ou edite direto o arquivo:
~/.cursor/mcp.jsonpara todos os projetos;.cursor/mcp.jsonna pasta do projeto, só para ele.
- Cole:
{
"mcpServers": {
"memberfy": {
"url": "https://api.memberfy.net/mcp"
}
}
}
- Salve. Em Cursor Settings › MCP, o servidor memberfy aparece pedindo login: clique para autenticar.
- No navegador, entre na Memberfy, escolha a comunidade e clique em Permitir.
- De volta ao Cursor, o servidor fica verde, com a lista de ferramentas.
- No chat do Cursor (modo agente), peça algo à Memberfy.
Outros clientes
Qualquer cliente MCP que suporte o transporte HTTP (streamable HTTP) e OAuth com descoberta automática funciona com o mesmo endereço. O servidor anuncia tudo o que o cliente precisa em https://api.memberfy.net/.well-known/oauth-protected-resource/mcp, e o cliente se registra sozinho. Clientes que só falam pelo transporte local (stdio) precisam de uma ponte para HTTP.
Detalhes técnicos
| Endereço | https://api.memberfy.net/mcp (só POST) |
| Transporte | HTTP, sem sessão: cada chamada é independente |
| Autorização | OAuth 2.1 com PKCE (S256), registro dinâmico de cliente |
| Retorno da autorização | https:// qualquer, ou http://localhost / http://127.0.0.1 para clientes locais |
| Escopos | read e write (padrão: os dois). Só com read, as ferramentas de criação e de dinheiro não aparecem |
| Token de acesso | 1 hora, renovado sozinho pelo cliente |
| Token de renovação | 30 dias, trocado a cada uso |
Mais em Segurança e limites.
Problemas na conexão
| O que acontece | O que fazer |
|---|---|
401 em todas as chamadas | A autorização não terminou ou foi desconectada. Rode /mcp (Claude Code) ou clique para autenticar (Cursor) de novo |
| O navegador não abre | Copie o link que o cliente mostra e abra à mão |
| "Este pedido de acesso não é válido." | Remova o servidor e adicione de novo; o registro do cliente pode ter ficado com outro endereço de retorno |
| Muitas chamadas em sequência começam a falhar | O limite é de 120 chamadas de ferramenta por minuto por conexão. Espere um minuto |
Mais casos em Problemas comuns.
Relacionados
- Visão geral do MCP
- Ferramentas
- API: para integrar com código, sem assistente