API & MCP: conecte um assistente de IA

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.

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.

Captura de tela

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:

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:

{
  "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:

{
  "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:

{
  "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:

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.

O endpoint MCP #

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:

{
  "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.

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?"

Endpoints de token #

A página acima chama estas rotas; o guia da equipe lista as mesmas ações na API pública (/v1/tokens).

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.