Crie com seu agente de código

A documentação do Rubry também é um servidor MCP, em https://docs.rubry.ai/mcp. Adicione ao seu agente de código (Claude Code, Cursor, VS Code, Codex, Gemini CLI, Windsurf, o app do Claude…) e peça o que você quer:

Crie um agente de suporte que responde a partir da nossa página de FAQ e consulta pedidos na nossa API, publique na minha conta da Cloudflare e conecte ao rubry.ai.

Seu agente de código lê esta documentação, escreve o agente e as ferramentas dele no template e segue os passos de publicação. Adicione também o servidor MCP da Cloudflare e ele cuida da parte da Cloudflare (bancos de dados, domínio, logs) sem você abrir o painel nem aprender o Wrangler.

É gratuito, somente leitura e não precisa de chave: ele só devolve documentação e código. Tudo o que ele sugere roda na sua máquina e nas suas contas, com a sua aprovação.

1. Adicione os servidores

Adicione o Rubry (https://docs.rubry.ai/mcp) e, para a infraestrutura, a Cloudflare (https://mcp.cloudflare.com/mcp, que pede login na Cloudflare na primeira vez).

Claude Code

claude mcp add --transport http rubry https://docs.rubry.ai/mcp
claude mcp add --transport http cloudflare https://mcp.cloudflare.com/mcp

Cursor

Em ~/.cursor/mcp.json (ou .cursor/mcp.json no projeto):

{
  "mcpServers": {
    "rubry": { "url": "https://docs.rubry.ai/mcp" },
    "cloudflare": { "url": "https://mcp.cloudflare.com/mcp" }
  }
}

VS Code (Copilot)

Em .vscode/mcp.json:

{
  "servers": {
    "rubry": { "type": "http", "url": "https://docs.rubry.ai/mcp" },
    "cloudflare": { "type": "http", "url": "https://mcp.cloudflare.com/mcp" }
  }
}

Codex

Em ~/.codex/config.toml:

[mcp_servers.rubry]
url = "https://docs.rubry.ai/mcp"

[mcp_servers.cloudflare]
url = "https://mcp.cloudflare.com/mcp"

Gemini CLI

Em ~/.gemini/settings.json:

{
  "mcpServers": {
    "rubry": { "httpUrl": "https://docs.rubry.ai/mcp" },
    "cloudflare": { "httpUrl": "https://mcp.cloudflare.com/mcp" }
  }
}

Windsurf

Em ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "rubry": { "serverUrl": "https://docs.rubry.ai/mcp" },
    "cloudflare": { "serverUrl": "https://mcp.cloudflare.com/mcp" }
  }
}

Claude (web e desktop)

Configurações → Conectores → Adicionar conector personalizado, com a URL https://docs.rubry.ai/mcp. Faça o mesmo com https://mcp.cloudflare.com/mcp.

Qualquer outro cliente que aceite servidores MCP remotos por HTTP ("Streamable HTTP") funciona do mesmo jeito.

2. Peça seu agente

Descreva o agente em palavras simples: para que serve, o que ele consulta ou faz e onde deve rodar. Por exemplo:

• "Crie um agente Rubry que escreve legendas de Instagram no tom da nossa marca e rode localmente."
• "Adicione ao meu agente pesquisador uma ferramenta que lê nossa página do Notion, com o token como segredo."
• "Publique meu template rubry na Cloudflare com o domínio agentes.exemplo.com.br e me dê o endpoint e uma chave para colar no rubry.ai."

Clientes que aceitam prompts MCP também oferecem o create-agent: escolha, descreva a ideia e ele faz o caminho todo, do template ao rubry.ai.

O que o servidor do Rubry oferece

Ferramenta	O que faz
search_docs	Busca nesta documentação, em inglês ou português
read_doc	Devolve uma página em Markdown (início rápido, agentes e ferramentas, publicação…)
list_docs	Lista as páginas
scaffold_agent	Escreve os arquivos de um novo agente e das ferramentas dele, nas convenções do template, mais a linha para adicionar em agents/src/index.ts e os segredos a definir
deploy_plan	Os passos de publicação para o seu caso (com ou sem o MCP da Cloudflare, domínio próprio, vários assistentes), em ordem

As páginas também ficam disponíveis como recursos MCP (rubry://docs/pt/<página>).

O que o servidor MCP da Cloudflare faz

O servidor MCP da Cloudflare dá ao seu agente de código a API inteira e a documentação da Cloudflare, na sua conta e com as permissões que você concede no login. Com ele, o agente consegue:

• encontrar sua conta e suas zonas;
• criar os dois bancos D1 que o template precisa e preencher os ids;
• ligar um domínio próprio ao middleware;
• ler os logs dos Workers quando algo falha.

O envio do código continua passando pelo npm run deploy (Wrangler), porque os Workers precisam ser empacotados antes; seu agente roda o comando por você.

Em CI, ou sem navegador, passe um token de API da Cloudflare como bearer token em vez de fazer login.

:::tip Mantenha os segredos fora do chat Segredos que o agente cria, como o SECRET_KEY, devem ser gerados e definidos num só comando, para nunca passarem pela conversa: openssl rand -hex 32 | npx wrangler secret put SECRET_KEY. O plano de publicação faz assim. O ADMIN_TOKEN é o que você precisa saber: guarde no seu gerenciador de senhas. :::

Indo além com o Mastra

Os agentes do template são agentes Mastra, então tudo o que o Mastra faz está à sua disposição. Para seu agente de código conhecer o kit completo do Mastra (workflows, memória, avaliações, clientes MCP…), dê a ele a documentação do Mastra também:

• A skill do Mastra, o caminho que o Mastra recomenda: veja Develop with AI.
• O servidor MCP de documentação do Mastra, rodando localmente: npx -y @mastra/mcp-docs-server@latest (no Claude Code: claude mcp add mastra -- npx -y @mastra/mcp-docs-server@latest). Se não puder rodar um servidor local, há um remoto em https://mastra.mcp.kapa.ai (login com Google, para limitar o uso).
• Texto puro: mastra.ai/llms.txt lista todas as páginas em Markdown.

Seus agentes também podem usar outros servidores MCP como ferramentas: o MCPClient do Mastra (@mastra/mcp) conecta um agente a servidores MCP remotos por HTTP, como o de um CRM ou de um banco de dados. No Workers, use servidores remotos (HTTP): servidores locais stdio não rodam lá.

Prefere não fazer você mesmo?

A Rubrion cria e opera agentes para empresas, nesta mesma base.