> ## Documentation Index
> Fetch the complete documentation index at: https://attlas.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Workspace MCP
> Crie chaves de API do Workspace para conectar assistentes de código de IA e ferramentas de desktop ao seu workspace do Attlas via MCP.
As chaves de API do Workspace permitem que ferramentas de desenvolvedor externas e assistentes de IA (Claude Code, Cursor, Claude Desktop, VS Code e Codex) se conectem a todo o seu workspace do Attlas usando o Model Context Protocol (MCP).
Ao contrário do endpoint público de MCP do chat, as chaves de API do workspace são credenciais privadas e com escopo que cobrem todos os chats, documentos de conhecimento, gatilhos, contatos e análises do seu workspace.
Após conectar o MCP, recomendamos instalar as [Attlas skills](/docs/pt/mcp/skills). Elas ensinam ao seu assistente a forma correta de usar essas ferramentas, para que solicitações como "coloque nossa página de preços no chat com perguntas abaixo" ou "configure meu novo chat" funcionem em uma única etapa.
***
## Início rápido
Conecte seu assistente de IA ao seu workspace do Attlas em três etapas:
1. No painel do Attlas, abra **Configurações do workspace**.
2. Vá para a aba **Chaves de API** (ou **MCP**).
3. Clique em **Criar chave de API**.
4. Insira um nome (por exemplo, `Cursor assistant` ou `Claude Code`).
5. Escolha as permissões (**Write** para criar e editar recursos, ou **Delete** se precisar de privilégios de exclusão).
6. Clique em **Criar chave** e copie sua chave secreta (`atk_...`) imediatamente.
Sua chave de API é exibida apenas uma vez. Armazene-a com segurança. O Attlas não pode exibir o segredo novamente após o fechamento do diálogo.
O endpoint MCP do workspace está hospedado em:
```text theme={null}
https://mcp.attlas.so
```
Selecione sua ferramenta de IA abaixo para copiar o comando de configuração ou o arquivo de configuração:
```bash Claude Code theme={null}
# Execute no terminal a partir do diretório do seu projeto:
claude mcp add attlas --transport http https://mcp.attlas.so \
--header "Authorization: Bearer atk_your_api_key"
```
```json Cursor theme={null}
{
"mcpServers": {
"attlas": {
"url": "https://mcp.attlas.so",
"headers": {
"Authorization": "Bearer atk_your_api_key"
}
}
}
}
```
```json Claude Desktop theme={null}
{
"mcpServers": {
"attlas": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.attlas.so",
"--header",
"Authorization: Bearer atk_your_api_key"
]
}
}
}
```
```json VS Code theme={null}
{
"servers": {
"attlas": {
"type": "http",
"url": "https://mcp.attlas.so",
"headers": {
"Authorization": "Bearer atk_your_api_key"
}
}
}
}
```
```toml Codex theme={null}
[mcp_servers.attlas]
command = "npx"
args = [
"mcp-remote",
"https://mcp.attlas.so",
"--header",
"Authorization: Bearer atk_your_api_key"
]
```
Se você usa o **Cursor**, clique no botão **Adicionar ao Cursor** diretamente na aba de chaves de API do Attlas para configurar a conexão com um único clique.
Teste sua configuração perguntando ao seu assistente:
```text theme={null}
List my Attlas chats
```
Seu assistente chamará a ferramenta `list_chats` e retornará a lista de chats com seus identificadores numéricos.
***
## Claude web e desktop (conector personalizado)
Para conectar a partir do claude.ai ou do aplicativo desktop do Claude, adicione o Attlas como um **conector personalizado**. O endpoint do workspace autentica com uma chave de API, não OAuth, portanto alguns campos precisam de valores específicos.
No Claude, vá para **Configurações → Conectores → Adicionar conector personalizado** (Team e Enterprise: **Configurações da organização → Conectores → Adicionar → Personalizado**).
```text theme={null}
https://mcp.attlas.so
```
Após continuar, o Claude faz uma sondagem da URL e pode pré-selecionar **Sempre obrigatório**, marcado como *Detectado*. Isso é um falso positivo: o servidor retorna `401` para a sondagem não autenticada, e o Claude interpreta isso como OAuth.
Selecione **Nenhuma** em vez disso. A descrição dessa opção diz explicitamente: *"ou para servidores que usam uma chave de API em vez de OAuth."* A seção **Cliente OAuth** desaparece.
Abra **Cabeçalhos de requisição** e adicione um cabeçalho:
| Campo | Valor |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Nome | `authorization` (escolha na lista; minúsculas são aceitáveis, nomes de cabeçalho HTTP não diferenciam maiúsculas/minúsculas) |
| Valor | `Bearer atk_your_api_key` |
| Obrigatório | marcado |
Insira o valor **exatamente** como o servidor espera, incluindo a palavra `Bearer` e um espaço antes da chave. O Claude envia o valor literalmente e não adiciona nenhum esquema. `atk_...` sozinho é enviado como `Authorization: atk_...` e o servidor rejeita com `401`.
Clique em **Adicionar** e, em seguida, habilite o Attlas a partir do menu **+** em uma conversa.
**Cabeçalhos de requisição** é um recurso beta disponível para um conjunto limitado de organizações. Se você não vir essa seção, conecte-se com o Claude Code ou `mcp-remote` (consulte [Início rápido](#inicio-rapido) acima).
### Solução de problemas
| Sintoma | Causa | Solução |
| --------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| A conexão falha, o Claude pede para fazer login com OAuth | Autenticação deixada em **Sempre obrigatório** ou o valor do cabeçalho está sem o prefixo `Bearer ` | Remova o conector e adicione novamente com **Nenhuma** e um valor correto de `Bearer atk_...` |
| `401` em todas as chamadas | Chave incorreta, revogada ou malformada; valor enviado sem `Bearer ` | Verifique a chave na aba **Chaves de API** do Attlas; adicione o conector novamente com o valor exato |
| Ferramentas não aparecem após a conexão | O escopo da chave não as inclui | Crie uma chave com escopo **Write** ou **Delete** |
| Funciona no Claude Code, mas não no claude.ai | O beta de cabeçalhos de requisição não está habilitado para sua organização | Use o Claude Code ou `mcp-remote`, ou entre em contato com o suporte do Claude para solicitar acesso |
***
## Escopos de permissão
Ao criar uma chave de API, selecione as permissões que correspondem ao seu caso de uso:
| Escopo | Rótulo na interface | O que pode fazer |
| ------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `read` | **Leitura** | Visualizar e pesquisar chats, documentos, gatilhos, contatos, conversas e análises. Incluído por padrão em todas as chaves. |
| `write` | **Escrita** | Criar e atualizar documentos, correções, gatilhos, contatos, branding, avatar, SEO e configurações do chat. Inclui automaticamente as permissões de Leitura. |
| `destructive` | **Exclusão** | Excluir permanentemente chats, documentos, gatilhos, contatos e conversas. Inclui automaticamente as permissões de Escrita e Leitura. |
Conceda a permissão de **Exclusão** apenas a fluxos de trabalho confiáveis onde a limpeza automatizada ou a exclusão de recursos seja explicitamente necessária.
***
## Requisitos de plano
O servidor MCP do workspace funciona em todos os planos. Algumas ações seguem os mesmos limites de plano do painel:
| Ação | Requisito |
| -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ler métricas, tendências, rankings ou gerar um relatório | O intervalo remonta apenas até a janela de histórico do seu plano (Free: 90 dias, Starter: 1 ano, PRO: 2 anos). Intervalos maiores são limitados a essa janela. |
| Adicionar um link de vídeo do YouTube, Instagram, TikTok, Facebook ou X a uma base de conhecimento | Starter ou PRO (transcrição de vídeo). Links de páginas da web funcionam em todos os planos. |
| Remover o selo de branding do Attlas (`update_branding`) | Complemento Brand. |
| Personalizar metadados de SEO do chat (`update_seo`) | Plano Basic ou superior. |
| Editar as configurações do banco de dados SQL conectado do chat | Starter ou PRO (integrações avançadas). |
***
## Recursos e ferramentas disponíveis
Uma vez conectado, seu assistente pode gerenciar todas as áreas do seu workspace:
### Configuração do chat, branding e pré-visualização ao vivo
* `preview_chat`: Renderiza uma pré-visualização interativa ao vivo do seu chat público dentro dos hosts do MCP Apps sem consumir créditos de mensagens ou afetar as análises.
* `update_chat`: Modifica a configuração do chat, metas e configurações de comportamento.
* `update_avatar`: Define o avatar do chat a partir de uma URL de imagem pública (hospedada automaticamente) ou de um emoji.
* `update_branding`: Mostra ou oculta o selo "Powered by Attlas" (requer o complemento Brand).
* `update_seo`: Define o título meta, a descrição meta e a imagem de compartilhamento social (`og:image`).
* `update_social_links`: Define os links de perfil de redes sociais (X, LinkedIn, Instagram, YouTube, TikTok, etc.) exibidos no chat.
* `update_theme` e `list_theme_presets`: Navegue e aplique temas de cores visuais.
* `set_personality` e `list_archetypes`: Personalize o tom e atribua arquétipos de persona.
### Conhecimento e aprendizado contínuo
* `create_document`: Adiciona documentos de texto diretamente à base de conhecimento.
* `update_document`: Edita o conteúdo de documentos de texto com ajuste automático de balanceamento de caracteres.
* `ingest_url`: Rastreia páginas da web ou transcreve links de vídeo (YouTube, TikTok, Instagram, X).
* `clean_document`: Reformata documentos importados com limpeza de Markdown por IA.
* `create_correction`: Ensina ao chat a resposta definitiva para perguntas que ele respondeu mal ou não conseguiu responder anteriormente.
### Gatilhos e captura de leads
* `list_triggers`, `create_trigger`, `update_trigger`, `reorder_triggers`: Gerencia botões, links e seções no chat público.
* `generate_questions`: Produz perguntas sugeridas para visitantes com base nos documentos enviados.
* `generate_and_nest`: Gera perguntas e as aninha sob um gatilho pai em uma única operação.
### Insights e sinais
* `list_signals`: Revise perguntas não respondidas (`weak_answer`), respostas com voto negativo (`thumbs_down`) e abandonos de visitantes (`left_after`).
* `list_conversations` e `read_conversation`: Inspecione conversas de visitantes e transcrições de mensagens.
* `get_metrics`, `get_timeseries`, `get_rankings`: Obtenha estatísticas de atividade e taxas de conversão.
* `generate_report` e `read_report`: Gere resumos estruturados do desempenho do chat.
***
## Monitoramento de atividade e registros de auditoria
A tabela **Atividade recente** na parte inferior da aba de chaves de API registra cada chamada MCP feita ao seu workspace:
* **Quando**: Carimbo de data/hora relativo da solicitação.
* **Chave**: Prefixo da chave usada (`atk_...`).
* **Ferramenta**: A ferramenta MCP chamada (por exemplo, `list_chats`, `create_document`, `delete_trigger`).
* **Alvo**: O recurso afetado pela operação.
* **Resultado**: Indicador de sucesso (`ok`) ou erro.
### Restaurar itens excluídos
Se uma ferramenta excluir acidentalmente um gatilho ou contato por engano, clique em **Restaurar** na linha de atividade para trazê-lo de volta ao seu workspace imediatamente.