# API & MCP: conecte um assistente de IA

_API · Leitura de 7 min · Atualizado 2026-10-22 · https://lanachat.ai/guides/pt/api-mcp/_

**API & MCP** (em Users, na parte inferior da barra lateral) permite conectar um assistente de IA, como Claude ou outro cliente MCP, para configurar e gerenciar seu workspace. MCP é um padrão aberto que permite que um assistente use ferramentas em um app em seu nome. Os mesmos tokens de acesso abrem a [REST API](https://lanachat.ai/guides/pt/api-overview/).

> Note: Apenas o proprietário do workspace e os donos da agência podem abrir esta página. Todos os outros veem "Owner access required".

## O que você precisa

- O **endpoint MCP**, mostrado no topo da página. Pressione **Copy URL**.
- Um **token de acesso** que define o que o assistente pode fazer.

## Criar um token de acesso

1. Pressione **Create token**.
2. Dê um nome e escolha o acesso: **Workspace setup**, ou **Custom permissions** para marcar uma a uma (por exemplo "Read fans and conversations" ou "Read sales").
3. Salve. O token é mostrado uma vez: pressione **Copy token**, ou **Copy client configuration** para obter uma configuração pronta para seu assistente.
4. Pressione **Done, I saved it**.

## Conecte seu assistente

1. Crie um acesso dedicado para este assistente (um token por ferramenta que você conectar).
2. Adicione a conexão HTTP MCP no seu assistente, com o endpoint e o token (passos exatos abaixo).
3. Pergunte o que ele pode ver, para verificar se as permissões estão corretas.
4. Trabalhe em rascunhos: deixe-o preparar mudanças, testá-las e depois publicar.

Os mesmos passos, com o endpoint, cabeçalho e configuração prontos para copiar, estão em **Connect your assistant** no final da página API & MCP. Em todos os exemplos abaixo, substitua a URL pela do seu workspace (**Copy URL**) e `YOUR_MCP_TOKEN` pelo seu token.

### Claude Code

Um comando no seu terminal:

```bash
claude mcp add --transport http lanachat https://app.lanachat.ai/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"
```

Depois digite `/mcp` no Claude Code: `lanachat` aparece como conectado, com suas ferramentas.

### Cursor

Adicione isto em `~/.cursor/mcp.json` (todos os projetos) ou `.cursor/mcp.json` (um projeto), depois ative `lanachat` em **Settings › MCP**:

```json
{
  "mcpServers": {
    "lanachat": {
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### VS Code (GitHub Copilot)

Adicione isto em `.vscode/mcp.json` no seu projeto:

```json
{
  "servers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### Claude Desktop

Claude Desktop inicia servidores locais a partir do arquivo de configuração, então ele acessa LanaChat através da pequena ponte `mcp-remote` (Node.js 18 ou superior). Abra **Settings › Developer › Edit Config** e adicione:

```json
{
  "mcpServers": {
    "lanachat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.lanachat.ai/mcp", "--header", "Authorization:${LANACHAT_AUTH}"],
      "env": { "LANACHAT_AUTH": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

Reinicie o Claude Desktop; as ferramentas do LanaChat aparecem no menu de ferramentas de um novo chat.

### ChatGPT e outros assistentes

Qualquer cliente MCP que possa enviar um cabeçalho numa conexão HTTP funciona com a configuração acima. Conectores web que só oferecem login OAuth (conectores ChatGPT, conectores customizados no claude.ai) não podem enviar um token de acesso, então ainda não podem se conectar.

### Verifique a conexão

O MCP Inspector lista as ferramentas que seu token abre, sem nenhum assistente:

```bash
npx @modelcontextprotocol/inspector
```

Escolha **Streamable HTTP**, cole o endpoint, adicione o cabeçalho `Authorization: Bearer YOUR_MCP_TOKEN`, depois **Connect** e **List tools**.

## Gerenciar tokens

A tabela **Access tokens** mostra as permissões, validade e status de cada token. Use **Edit**, **Rotate** (ou **Renew**) e **Revoke**. **Show revoked tokens** lista os antigos.

> Warning: Um token funciona como uma senha. Revogue-o assim que parar de usar o assistente ou suspeitar que vazou.

## O endpoint MCP

| Method | Path | Description | Permission | Status |
|---|---|---|---|---|
| POST | `https://app.lanachat.ai/mcp` | O servidor MCP (Streamable HTTP): todas as chamadas de ferramenta vão aqui | qualquer token | Planned |
| GET | `https://app.lanachat.ai/mcp` | Abre o stream de eventos da sessão | qualquer token | Planned |
| POST | `https://app.lanachat.ai/api/media/uploads` | Uploads de mídia de um assistente, com o mesmo token | `can_setup` | Planned |

A URL exata do seu workspace é mostrada no topo da página API & MCP (**Copy URL**). O token vai no cabeçalho `Authorization`, como na API. Uma configuração cliente fica assim:

```json
{
  "mcpServers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

## Ferramentas que o assistente acessa

O assistente só vê as ferramentas que seu token permite. Uma ferramenta que ele não pode usar não aparece. Quando conecta, o servidor envia os argumentos exatos de cada ferramenta (nome, tipo, obrigatório) para o assistente, para que você nunca precise digitá-los. A última coluna é o endpoint da API que faz o mesmo, onde seus parâmetros são documentados.

| Tool | O que faz | Permissão | Igual na API |
|---|---|---|---|
| `list_creators`, `get_creator` | Ler criadoras, identidade e progresso da configuração | `can_setup` | [`GET /creators`](https://lanachat.ai/guides/pt/api-creators/) |
| `update_creator`, `update_persona` | Alterar identidade ou páginas de persona da criadora | `can_setup`, `can_engine` para a persona | [`PUT …/identity`, `PATCH …/persona`](https://lanachat.ai/guides/pt/api-creators/) |
| `list_accounts`, `update_account` | Ler contas Telegram, mudar brain, market ou traffic | `can_setup` | [`GET /accounts`, `PATCH /accounts/{id}`](https://lanachat.ai/guides/pt/api-telegram-accounts/) |
| `list_media`, `upload_media`, `update_media`, `create_media_folder` | Adicionar mídia ao Vault, organizar, sugerir descrições (mostradas para revisão antes de salvar) | `can_setup` | [`/media`](https://lanachat.ai/guides/pt/api-vault/) |
| `list_scripts`, `draft_script`, `update_script` | Ler scripts e criar rascunhos: passos, mídia e preços Stars | `can_setup` | [`/scripts`](https://lanachat.ai/guides/pt/api-scripts/) |
| `list_members`, `update_member` | Ler e alterar membros da equipe | `can_setup` | [`/members`](https://lanachat.ai/guides/pt/api-team/) |
| `get_brain`, `update_brain_draft`, `test_brain` | Ler um brain, editar rascunho, testar no Playground | `can_engine` | [`/brains`, `/playground`](https://lanachat.ai/guides/pt/api-ai-brains/) |
| `publish_brain` | Publicar rascunho de brain comum | `can_publish` | [`POST /brains/{id}/publish`](https://lanachat.ai/guides/pt/api-ai-brains/) |
| `test_advanced_ai`, `tune_advanced_ai`, `publish_advanced_ai` | Rascunhos, configurações e perfis de AI avançada (só dono do workspace) | `can_ai_test`, `can_ai_tune`, `can_ai_publish` | Nenhum |
| `list_experiment_reports` | Ler relatórios de experimentos comerciais (só dono do workspace) | `can_commercial_reports` | Nenhum |
| `list_fans`, `get_conversation` | Ler fãs e histórico de conversas | `can_fan_read` | [`GET /fans`, `GET /conversations/{id}/messages`](https://lanachat.ai/guides/pt/api-conversations/) |
| `import_fan_history` | Adicionar fãs e mensagens antigas ao registro; nunca envia mensagem | `can_fan_import` | [`POST /fans/import`](https://lanachat.ai/guides/pt/api-conversations/) |
| `list_sales` | Ler vendas registradas para relatórios | `can_sales_read` | [`GET /fans/{id}/sales`](https://lanachat.ai/guides/pt/api-conversations/), [`GET /stats`](https://lanachat.ai/guides/pt/api-tracking/) |

> Note: Desligar **Access AI configuration** também remove permissões de publicação, Advanced AI e relatórios de experimentos. Workspace setup e permissões de fãs e vendas permanecem independentes. Nenhuma ferramenta envia mensagem para fã.

## O que pedir ao assistente

Fale com ele como um colega que conhece o Console. Alguns prompts que funcionam bem:

- "Liste minhas criadoras e diga quais têm configuração incompleta."
- "Leia a persona da Lea e sugira três respostas prontas para fãs que perguntam se ela é real. Não salve nada."
- "Crie um script de recuperação para a Lea: três passos em dois dias, o último um set pago de 250 Stars. Deixe inativo."
- "Faça upload das fotos desta pasta para o Vault da Lea, numa pasta chamada Beach, e sugira uma descrição para cada uma."
- "Altere o rascunho do brain da Lea para que a primeira oferta apareça após 6 mensagens, teste no Playground com um fã que fala inglês, e me mostre as respostas antes de publicar."
- "Quanto cada criadora vendeu ontem, e qual link de rastreamento trouxe mais compradores esta semana?"

> Tip: Peça para trabalhar em rascunhos e mostrar o resultado antes de publicar. Publicar precisa de token com **Publish AI Brain drafts**: deixe desligado se quiser ter a última palavra.

## Endpoints de token

A página acima chama estas rotas; o [guia da equipe](https://lanachat.ai/guides/pt/api-team/) lista as mesmas ações na API pública (`/v1/tokens`).

| Method | Path | Description | Permission | Status |
|---|---|---|---|---|
| GET | `/api/mcp/tokens` | Lista tokens, permissões, validade e status | `owner` | Planned |
| POST | `/api/mcp/tokens` | Cria um token (mostrado uma vez) | `owner` | Planned |
| PUT | `/api/mcp/tokens/{id}` | Edita nome ou permissões | `owner` | Planned |
| POST | `/api/mcp/tokens/{id}/rotate` | Gira o segredo | `owner` | Planned |
| DELETE | `/api/mcp/tokens/{id}` | Revoga o token | `owner` | Planned |

Essas rotas do Console recebem e retornam as permissões como campos booleanos (`can_setup`, `can_engine`, `can_publish`, `can_ai_test`, `can_ai_tune`, `can_ai_publish`, `can_commercial_reports`, `can_fan_read`, `can_fan_import`, `can_sales_read`). Criar um token responde `{ "token": "…", "grant": { … } }`: `token` é o segredo, mostrado uma vez; `grant` é o acesso com seu `id`, `name`, `scope`, `enabled`, `created` e `expires` (segundos Unix). Girar revoga o acesso antigo e responde um novo `token` e `grant`. Nome ausente responde `400`, id desconhecido `404`, acesso revogado `409`.

Mais na [página do recurso API and MCP](https://lanachat.ai/landing/features/api-and-mcp/).

## Artigos relacionados

- [API LanaChat: início rápido, autenticação e erros](https://lanachat.ai/guides/pt/api-overview/)
- [Receitas rápidas da API: copiar, colar, executar](https://lanachat.ai/guides/pt/api-recipes/)
- [O que é um AI Brain](https://lanachat.ai/guides/pt/what-is-an-ai-brain/)