# 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.

> [!TIP]
> 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:

```bash
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:

```json
{
  "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](/mcp/conectar-o-claude#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:

```json
{
  "mcpServers": {
    "memberfy": {
      "url": "https://api.memberfy.net/mcp"
    }
  }
}
```

3. Salve. Em **Cursor Settings › MCP**, o servidor **memberfy** aparece pedindo login: clique para autenticar.
4. No navegador, entre na Memberfy, escolha a **comunidade** e clique em **Permitir**.
5. De volta ao Cursor, o servidor fica verde, com a lista de ferramentas.
6. 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](/mcp/seguranca).

## 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](/mcp/problemas-comuns).

## Relacionados

- [Visão geral do MCP](/mcp/o-que-e-o-mcp)
- [Ferramentas](/mcp/ferramentas)
- [API](/api/introducao): para integrar com código, sem assistente