Saltar para o conteúdo

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

  1. Abra o Claude Code e digite /mcp.
  2. Escolha memberfy e a opção de autenticar.
  3. O navegador abre a tela da Memberfy. Entre, escolha a comunidade e clique em Permitir.
  4. Volte ao terminal: o servidor aparece como conectado, com as ferramentas.
  5. 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

  1. Abra Cursor Settings › MCP e adicione um servidor, ou edite direto o arquivo:
    • ~/.cursor/mcp.json para todos os projetos;
    • .cursor/mcp.json na pasta do projeto, só para ele.
  2. Cole:
{
  "mcpServers": {
    "memberfy": {
      "url": "https://api.memberfy.net/mcp"
    }
  }
}
  1. Salve. Em Cursor Settings › MCP, o servidor memberfy aparece pedindo login: clique para autenticar.
  2. No navegador, entre na Memberfy, escolha a comunidade e clique em Permitir.
  3. De volta ao Cursor, o servidor fica verde, com a lista de ferramentas.
  4. 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çohttps://api.memberfy.net/mcp (só POST)
TransporteHTTP, sem sessão: cada chamada é independente
AutorizaçãoOAuth 2.1 com PKCE (S256), registro dinâmico de cliente
Retorno da autorizaçãohttps:// qualquer, ou http://localhost / http://127.0.0.1 para clientes locais
Escoposread e write (padrão: os dois). Só com read, as ferramentas de criação e de dinheiro não aparecem
Token de acesso1 hora, renovado sozinho pelo cliente
Token de renovação30 dias, trocado a cada uso

Mais em Segurança e limites.

Problemas na conexão

O que aconteceO que fazer
401 em todas as chamadasA autorização não terminou ou foi desconectada. Rode /mcp (Claude Code) ou clique para autenticar (Cursor) de novo
O navegador não abreCopie 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 falharO limite é de 120 chamadas de ferramenta por minuto por conexão. Espere um minuto

Mais casos em Problemas comuns.

Relacionados