Studio no Claude Desktop: o servidor MCP local

O Praeko Studio normalmente é operado por um agente com terminal. O @praeko/studio-mcp é um servidor MCP que roda na sua máquina e expõe as mesmas etapas como ferramentas, para um agente sem terminal (o Claude Desktop, por exemplo) criar o episódio, escrever o roteiro, fazer a voz, renderizar, gerar a capa e subir o vídeo para o Praeko. Ele roda o CLI do Studio por baixo, por stdio: nenhuma porta é aberta.

Dois servidores, dois papéis

Os nomes não colidem: o cliente prefixa cada ferramenta com o nome do servidor. Os dois podem ficar ligados ao mesmo tempo.

O fluxo sem terminal

Instalar

Crie o projeto uma vez (npx @praeko/studio init meu-canal: o comando termina imprimindo as duas linhas de instalação deste servidor com a pasta certa). Depois aponte o servidor para a pasta do projeto, a que tem brand.json; use o caminho absoluto.

claude mcp add praeko-studio -- npx -y @praeko/studio-mcp --project <pasta>

{
  "command": "npx",
  "args": [
    "-y",
    "@praeko/studio-mcp",
    "--project",
    "<pasta>"
  ]
}

Um bloco por cliente

Os formatos abaixo foram conferidos nas páginas dos fabricantes em 08/11/2026; onde não deu para conferir, a página diz.

Claude Code

Um comando registra o servidor (o -- separa as opções do Claude do comando do servidor). O padrão guarda só para você, neste projeto; --scope user vale para todos.

claude mcp add praeko-studio -- npx -y @praeko/studio-mcp --project <pasta>

{
  "mcpServers": {
    "praeko-studio": {
      "command": "npx",
      "args": [
        "-y",
        "@praeko/studio-mcp",
        "--project",
        "<pasta>"
      ]
    }
  }
}

Claude Desktop

Em Configurações, aba Desenvolvedor (Developer), clique em Editar configuração (Edit Config). O arquivo é ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows) ou ~/.config/Claude/claude_desktop_config.json (Linux). Cole o bloco, feche o Claude Desktop por completo e abra de novo. Use o caminho absoluto da pasta.

{
  "mcpServers": {
    "praeko-studio": {
      "command": "npx",
      "args": [
        "-y",
        "@praeko/studio-mcp",
        "--project",
        "<pasta>"
      ]
    }
  }
}

Cursor

No .cursor/mcp.json do projeto, ou em ~/.cursor/mcp.json para todos. Servidor local pede type: stdio.

{
  "mcpServers": {
    "praeko-studio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@praeko/studio-mcp",
        "--project",
        "<pasta>"
      ]
    }
  }
}

Codex

Um comando (o -- separa o comando do servidor) ou a tabela [mcp_servers.<nome>] no ~/.codex/config.toml (ou .codex/config.toml de um projeto confiável).

codex mcp add praeko-studio -- npx -y @praeko/studio-mcp --project <pasta>

[mcp_servers.praeko-studio]
command = "npx"
args = ["-y","@praeko/studio-mcp","--project","<pasta>"]

Gemini CLI

No .gemini/settings.json do projeto, ou em ~/.gemini/settings.json para todos.

{
  "mcpServers": {
    "praeko-studio": {
      "command": "npx",
      "args": [
        "-y",
        "@praeko/studio-mcp",
        "--project",
        "<pasta>"
      ]
    }
  }
}

opencode

No opencode.json (ou opencode.jsonc); o servidor local usa type: local e o comando inteiro como lista.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "praeko-studio": {
        "type": "local",
        "command": [
          "npx",
          "-y",
          "@praeko/studio-mcp",
          "--project",
          "<pasta>"
        ]
      }
    }
  }
}

Outro cliente (genérico)

Qualquer cliente que rode servidor MCP local por stdio aceita o mesmo trio: comando, argumentos e (se precisar) variáveis de ambiente. Os nomes dos campos variam por cliente: confira na documentação do cliente.

{
  "mcpServers": {
    "praeko-studio": {
      "command": "npx",
      "args": [
        "-y",
        "@praeko/studio-mcp",
        "--project",
        "<pasta>"
      ]
    }
  }
}

command: npx
args:    ["-y","@praeko/studio-mcp","--project","<pasta>"]
server:  stdio (no port, no URL)

As 14 ferramentas

Segurança

Se der errado