> ## Documentation Index
> Fetch the complete documentation index at: https://docs.levios.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP

> Conecte um cliente de IA compatível ao servidor MCP da levios por OAuth, liste as ferramentas disponíveis e invoque operações com escopo na sua conta.

O servidor MCP da levios permite que clientes de IA compatíveis usem as
ferramentas da levios depois que você aprova permissões e contas específicas
do Instagram.

Use este endpoint MCP remoto:

```text theme={null}
https://levios.app/api/mcp
```

## Planeje um resultado

Comece em [Crie sua primeira automação pelo chat](/pt-BR/mcp/first-automation).
Compare [objetivos](/pt-BR/mcp/choose-objective), use um
[follow gate](/pt-BR/mcp/follow-gate) quando a prioridade for crescimento ou
encontre [contatos estratégicos](/pt-BR/mcp/strategic-contacts). Leia
[Limites do Instagram](/pt-BR/mcp/instagram-limits) antes de prometer uma sequência.

Quando `tools/list` expuser `get_automation_guide`, o agente pode consultar a
orientação, a permissão de salvar rascunhos e o caminho de ativação da conexão.
A ferramenta não verifica a elegibilidade da conta ou do plano. Se a versão do servidor ainda não a expuser, compartilhe
essas páginas.

## Conecte um cliente

1. Copie o endpoint acima.
2. No seu cliente de IA, adicione um aplicativo personalizado, um conector ou
   um servidor MCP remoto.
3. Cole o endpoint e confirme a conexão.
4. Entre na levios na janela do navegador que será aberta.
5. Confira as permissões e contas solicitadas e aprove a requisição.
6. Volte ao cliente e peça que ele liste suas contas da levios.

O OAuth gerencia a conexão. Não cole uma chave de API, um token de acesso ou
outro segredo no formulário de configuração do cliente.

## Guias de configuração

Cada guia carrega a evidência que a levios tem para aquele cliente. Leia o aviso
no topo antes de confiar no guia.

<Columns cols={3}>
  <Card title="Claude" icon="https://mintcdn.com/levios/fqbf-TFlhKASg0IQ/logo/ai/claude.svg?fit=max&auto=format&n=fqbf-TFlhKASg0IQ&q=85&s=a8438058c51153bd9c5d0cb29ec6d509" href="/pt-BR/mcp/claude" horizontal width="24" height="24" data-path="logo/ai/claude.svg" />

  <Card title="Claude Code" icon="https://mintcdn.com/levios/fqbf-TFlhKASg0IQ/logo/ai/claude-code.svg?fit=max&auto=format&n=fqbf-TFlhKASg0IQ&q=85&s=1e1aca457ca191899364b5779be0ec98" href="/pt-BR/mcp/claude-code" horizontal width="24" height="24" data-path="logo/ai/claude-code.svg" />

  <Card title="Cursor" icon="https://mintcdn.com/levios/fqbf-TFlhKASg0IQ/logo/ai/cursor.svg?fit=max&auto=format&n=fqbf-TFlhKASg0IQ&q=85&s=22ccb7b6cbebd5af96db35c7b4039f70" href="/pt-BR/mcp/cursor" horizontal width="24" height="24" data-path="logo/ai/cursor.svg" />

  <Card title="ChatGPT" icon="https://mintcdn.com/levios/fqbf-TFlhKASg0IQ/logo/ai/openai.svg?fit=max&auto=format&n=fqbf-TFlhKASg0IQ&q=85&s=2b60dd6649280567e46565b26f07ed12" href="/pt-BR/mcp/chatgpt" horizontal width="24" height="24" data-path="logo/ai/openai.svg" />

  <Card title="ChatGPT Work" icon="https://mintcdn.com/levios/fqbf-TFlhKASg0IQ/logo/ai/openai.svg?fit=max&auto=format&n=fqbf-TFlhKASg0IQ&q=85&s=2b60dd6649280567e46565b26f07ed12" href="/pt-BR/mcp/chatgpt-work" horizontal width="24" height="24" data-path="logo/ai/openai.svg" />

  <Card title="Codex" icon="https://mintcdn.com/levios/fqbf-TFlhKASg0IQ/logo/ai/openai.svg?fit=max&auto=format&n=fqbf-TFlhKASg0IQ&q=85&s=2b60dd6649280567e46565b26f07ed12" href="/pt-BR/mcp/codex" horizontal width="24" height="24" data-path="logo/ai/openai.svg" />

  <Card title="VS Code" icon="https://mintcdn.com/levios/fqbf-TFlhKASg0IQ/logo/ai/vscode.svg?fit=max&auto=format&n=fqbf-TFlhKASg0IQ&q=85&s=6553225f93afe4b5b40bcae8895e61cd" href="/pt-BR/mcp/vscode" horizontal width="24" height="24" data-path="logo/ai/vscode.svg" />

  <Card title="Gemini CLI" icon="https://mintcdn.com/levios/fqbf-TFlhKASg0IQ/logo/ai/gemini.svg?fit=max&auto=format&n=fqbf-TFlhKASg0IQ&q=85&s=593c8f581b24ec6bbd82881d12fd96a3" href="/pt-BR/mcp/gemini-cli" horizontal width="24" height="24" data-path="logo/ai/gemini.svg" />

  <Card title="Antigravity" icon="rocket" href="/pt-BR/mcp/antigravity" horizontal />

  <Card title="Perplexity" icon="https://mintcdn.com/levios/fqbf-TFlhKASg0IQ/logo/ai/perplexity.svg?fit=max&auto=format&n=fqbf-TFlhKASg0IQ&q=85&s=1cf3e9a752f89faff1c7abe91052a751" href="/pt-BR/mcp/perplexity" horizontal width="24" height="24" data-path="logo/ai/perplexity.svg" />

  <Card title="Grok" icon="bolt" href="/pt-BR/mcp/grok" horizontal />

  <Card title="Grok Bot" icon="robot" href="/pt-BR/mcp/grokbot" horizontal />

  <Card title="Devin" icon="code-branch" href="/pt-BR/mcp/devin" horizontal />

  <Card title="Hermes Agent" icon="feather-pointed" href="/pt-BR/mcp/hermes" horizontal />

  <Card title="OpenClaw" icon="terminal" href="/pt-BR/mcp/openclaw" horizontal />
</Columns>

Um cliente que não está nesta lista ainda pode funcionar. O endpoint é um
servidor MCP remoto padrão, então qualquer cliente com suporte a MCP remoto
sobre OAuth consegue se conectar a ele.

## Superfície disponível

A levios publica ferramentas MCP. Ela não publica recursos nem prompts MCP.

As ferramentas que um cliente pode ver dependem das permissões aprovadas. O
cliente pode descobrir as ferramentas permitidas para contas, mídias do
Instagram, automações, contatos, métricas, configurações e mudanças de
ativação. Uma ferramenta fora da autorização não aparece na lista do cliente.
Todas as chamadas de ferramenta ficam restritas às contas incluídas na
autorização.

Seu cliente recebe os schemas JSON autoritativos de entrada e saída por
`tools/list`. Esses schemas incluem campos obrigatórios, valores de enum e a
`configuration` completa e tipada da automação. Os payloads não são objetos
livres.

As ferramentas que operam em uma conta aceitam `account_id` como UUID ou
`@username`. Omita esse campo somente quando a autorização OAuth alcançar
exatamente uma conta. Se houver várias contas, use `list_accounts` ou os
campos `account_cursor` e `account_limit` expostos pelo schema da
ferramenta.

## Ferramentas disponíveis

| Ferramenta | Permissão | Objetivo |
| - | - | - |
| `list_accounts` | Autorização OAuth | Lista as contas do Instagram disponíveis para a conexão. |
| `get_automation_guide` | Autorização OAuth | Consulte orientações e receitas por objetivo sem acessar dados da conta. |
| `get_automation_schema` | Autorização OAuth | Consulte os campos exatos da configuração e um exemplo ilustrativo sem acessar a conta. |
| `validate_automation_configuration` | Autorização OAuth | Valide e visualize a configuração JSON; compare revisões sem salvar nem ativar. |
| `list_automations` | `automations:read` | Lista as automações de uma conta. |
| `get_automation` | `automations:read` | Lê uma automação com sua configuração completa. |
| `list_instagram_media` | `automations:read` | Lista os posts ou os stories de uma conta para vincular gatilhos. |
| `create_automation` | `automations:write` | Cria uma automação a partir de uma configuração tipada completa. |
| `update_automation` | `automations:write` | Renomeia uma automação ou substitui toda a configuração tipada dela. |
| `delete_automation` | `automations:write` | Arquiva uma automação com concorrência otimista. |
| `activate_automation` | `automations:activate` | Mostra a publicação, pede confirmação e ativa a automação. |
| `deactivate_automation` | `automations:activate` | Mostra a pausa, pede confirmação e interrompe o processamento de novos gatilhos. |
| `list_contacts` | `contacts:read_pii` | Lista contatos completos com filtro opcional e exato por username do Instagram. |
| `get_contact` | `contacts:read_pii` | Lê um contato completo e sua timeline de atividade limitada. |
| `list_contact_tags` | `contacts:write` | Lista tags de contato reutilizáveis. |
| `create_contact_tag` | `contacts:write` | Cria uma tag de contato normalizada. |
| `update_contact_tag` | `contacts:write` | Renomeia uma tag de contato. |
| `delete_contact_tag` | `contacts:write` | Exclui uma tag que não está mais em uso. |
| `attach_contact_tag` | `contacts:write` | Adiciona uma tag existente a um contato. |
| `detach_contact_tag` | `contacts:write` | Remove uma tag de um contato. |
| `get_metrics` | `metrics:read` | Lê métricas da conta em uma janela de `7d` ou `30d`. |
| `get_automation_metrics` | `metrics:read` | Lê métricas vitalícias e dos últimos sete dias de uma automação. |

Nas alterações de ativação, e ao criar uma automação que já começa `live`, a
ferramenta primeiro mostra uma prévia e pergunta se deve aplicá-la. Uma
resposta positiva autoriza apenas essa transição de curta duração. Uma
alteração posterior na configuração a invalida.

As operações de leitura e as alterações usam permissões diferentes. Pausar
uma autorização OAuth mantém as leituras permitidas e bloqueia as
alterações. Você pode pausar ou revogar uma conexão em **Settings > MCP** na
levios.

## Compatibilidade do protocolo

O caminho moderno do servidor implementa o MCP `2026-07-28`. A levios também
mantém um caminho de compatibilidade sem estado para o formato de comunicação
de 2025 usado por alguns clientes. Os dois caminhos usam a mesma autorização
OAuth, os mesmos limites de conta, as mesmas verificações de permissão e o
mesmo registro de ferramentas.

## Mensagens em carrossel

Use [Criar um carrossel com um agente](/pt-BR/mcp/carousels) para planejar e
validar cards com imagens, botões de link e a ação seguinte.

## Guias de criação

* [Criação e edição](/pt-BR/guides/automation-workflow)
* [Configuração](/pt-BR/guides/automation-configuration)
* [Triggers](/pt-BR/guides/automation-triggers)
* [Actions](/pt-BR/guides/automation-actions)
* [Criação pelo MCP](/pt-BR/mcp/automation-authoring)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.