# Use o Praeko com o seu agente de IA

> Conecte Claude Code, Codex, Cursor, Gemini CLI, opencode e outros agentes ao Praeko: servidor MCP com chave ou login, arquivo de regras, llms.txt e openapi.json.

Fonte: https://praeko.app/docs/agents

Conecte o agente ao servidor MCP do Praeko: ele lê esta documentação e opera a sua conta com uma chave de API ou pelo login por OAuth. O escopo limita o que ele pode fazer, e toda ação de escrita pede uma confirmação em dois passos.

## Caminhos para qualquer agente

| Caminho | O que é | Situação |
|---|---|---|
| [Servidor MCP remoto](https://praeko.app/docs/mcp) | Busca e lê as páginas das docs, consulta canais, mídia, posts, calendário e métricas e, com a sua aprovação, cria, agenda, edita e cancela posts, em `praeko.app/mcp`. Entra com uma chave de API (`Authorization: Bearer`) ou pelo login por OAuth, que você gerencia em Conexões de agentes, no painel. Webhooks, chaves e conexão de canais ficam de fora. | (no ar) |
| [`/llms.txt` e `/llms-full.txt`](https://praeko.app/llms.txt) | O índice das docs e o texto completo, para agentes que leem uma URL. | (no ar) |
| [`/openapi.json`](https://praeko.app/openapi.json) | O contrato completo, para gerar clientes ou dar ao agente. | (no ar) |
| Copiar como Markdown | Botão em cada página, e o endereço `.md` de cada uma. | (no ar) |
| [Praeko Studio](https://praeko.app/docs/studio) | Faz o vídeo com o **seu** agente (Claude Code, Codex, Gemini CLI, Cursor, opencode…) na sua máquina: `praeko studio skill install` grava as instruções no formato de cada agente, com a regra de dois passos para publicar. Sem terminal, use o [MCP local do Studio](https://praeko.app/docs/studio/mcp). O Remotion, motor padrão, não é MIT. | (no ar) |
| Trecho para `AGENTS.md` | Regras curtas de uso da API; um modelo na página de cada agente. | (no ar) |

## Dois servidores MCP

|  | `praeko` (remoto) | `praeko-studio` (local) |
|---|---|---|
| Onde roda | `https://praeko.app/mcp` | Na sua máquina, por stdio (`npx -y @praeko/studio-mcp`) |
| Para quê | Canais, mídia, posts, métricas e docs | Criar o episódio, roteiro, voz, render, capa e subir os arquivos (14 ferramentas) |
| Publica? | Sim, sempre em duas etapas | Nunca |
| Pede | Uma chave de API ou o login por OAuth | Node, Chrome/Remotion e as suas chaves, na sua máquina |

O fluxo de ponta a ponta: **criar** e **renderizar** no `praeko-studio`, **`studio_upload`** (devolve só o `mediaId`) e **`create_post`** no `praeko`, com a sua aprovação. Com terminal, o agente também pode operar o Studio pelo CLI; sem terminal, use o [MCP local do Studio](https://praeko.app/docs/studio/mcp).

> **Do zero ao primeiro vídeo com o seu agente** Depois de escolher o agente, siga [Começar com o seu agente](https://praeko.app/docs/get-started-with-agent): um prompt cria o projeto, monta o primeiro vídeo e prepara a publicação, e você só aprova.

## Escolha o seu agente

Verificado nas docs de cada fabricante em 07/11/2026. Selos: **Validado**: arquivo de regras e MCP remoto com cabeçalho conferidos na página do fabricante. **Parcial**: parte conferida (a nota diz qual). **Sem MCP** ou **Não verificado**: a página do fabricante não mostra o que precisamos; a página do agente leva só ao caminho por llms.txt, openapi.json ou API direta.

### Terminal

| Agente | Selo | Regras | MCP remoto |
|---|---|---|---|
| [Claude Code](https://praeko.app/docs/agents/claude-code) | (Validado) | `CLAUDE.md`; lê também `AGENTS.md` | `claude mcp add --transport http --header`, ou login por OAuth (`/mcp`) |
| [Codex CLI](https://praeko.app/docs/agents/codex-cli) | (Validado) | `AGENTS.md` | `config.toml`, `bearer_token_env_var` |
| [Gemini CLI](https://praeko.app/docs/agents/gemini-cli) | (Validado) | `GEMINI.md` | `settings.json`, `httpUrl` + `headers` |
| [opencode](https://praeko.app/docs/agents/opencode) | (Parcial) | `AGENTS.md` | `opencode.json`, `type: remote` + `headers` (layout por versão a confirmar) |
| [Kimi CLI](https://praeko.app/docs/agents/kimi-cli) | (Validado) | `AGENTS.md` (`/init`) | `~/.kimi/mcp.json`, `url` + `headers` |
| [Goose](https://praeko.app/docs/agents/goose) | (Parcial) | `AGENTS.md` ou `.goosehints` | `streamable_http` com OAuth; cabeçalho não documentado |
| [Amp](https://praeko.app/docs/agents/amp) | (Não verificado) | Não verificado | Não verificado |
| [Aider](https://praeko.app/docs/agents/aider) | (Sem MCP) | `CONVENTIONS.md` com `--read` | Sem MCP documentado |

### Editor

| Agente | Selo | Regras | MCP remoto |
|---|---|---|---|
| [Cursor](https://praeko.app/docs/agents/cursor) | (Validado) | `.cursor/rules/*.mdc` e `AGENTS.md` | `.cursor/mcp.json`, `url` + `headers` |
| [Cline](https://praeko.app/docs/agents/cline) | (Validado) | `.clinerules/` e `AGENTS.md` | `streamableHttp` + `headers` |
| [Zed](https://praeko.app/docs/agents/zed) | (Parcial) | Não verificado | `settings.json`, `context_servers`, `url` + `headers` |
| [GitHub Copilot](https://praeko.app/docs/agents/copilot) | (Parcial) | `.github/copilot-instructions.md` e `AGENTS.md` | CLI: `type: http` + `headers`. VS Code: formato a conferir |
| [Windsurf (Devin)](https://praeko.app/docs/agents/windsurf) | (Parcial) | `AGENTS.md`, `.devin/rules`; lê também `.windsurf/rules` | `.devin/mcp_config.json`, `url` + `headers`; exemplo com Bearer a confirmar |
| [Continue](https://praeko.app/docs/agents/continue) | (Parcial) | `.continue/rules/` | `streamable-http`; cabeçalho não documentado |

### Aplicativo

| Agente | Selo | Regras | MCP remoto |
|---|---|---|---|
| [Claude Desktop](https://praeko.app/docs/agents/claude-desktop) | (Validado) | Sem arquivo de projeto | Conector personalizado com login por OAuth, ou cabeçalho |

### Automação

| Agente | Selo | Regras | MCP remoto |
|---|---|---|---|
| [n8n](https://praeko.app/docs/agents/n8n) | (Validado) | Não se aplica | Automação: nó HTTP Request com Header Auth |
| [Zapier](https://praeko.app/docs/agents/zapier) | (Parcial) | Não se aplica | Automação: Webhooks by Zapier, só fontes da comunidade |
| [Make](https://praeko.app/docs/agents/make) | (Parcial) | Não se aplica | Automação: módulo HTTP, só fontes da comunidade |