Documentação

MCP do DeployRápido

Última atualização: 26 de setembro de 2026

Use esta página para conectar um agente de IA (Cursor, Claude, ChatGPT) ao seu time. A chave MCP autentica o agente; o time vem só da chave, nunca de um tenant_id enviado pelo cliente.

Autenticação

Gateway: POST https://deployrapido.com.br/api/team-mcp-gateway com o header x-api-key: drmcp_… (ou Authorization: Bearer drmcp_…). Gere a chave no dashboard (ou clique em Conecte seu agente). A chave bruta aparece só uma vez. Chaves com canDeploy podem publicar e alterar apps; sem canDeploy, só leitura.

Segurança

Nunca cole senhas em chats públicos. O agente pode mostrar credenciais só ao dono do app. Deploys e mudanças de env exigem canDeploy. O agente não pode apagar apps — exclusão só no site, com confirmação. Chaves de env da plataforma (BLOCKED_INSTANCE_ENV_KEYS) são recusadas. Uma chave do time A nunca lê ou altera o time B.

Apagar apps

Não existe ferramenta de exclusão no MCP. Se o agente tentar delete_app, a resposta é: “Para apagar, abra o site e confirme. O agente não pode apagar.”

Leitura do time

  • list_deployments

    Lista os apps do time (nome, serviço, status, URL).

  • describe_deployment

    Detalhes de um deploy pelo nome (sem senha).

  • query_deployment_db

    SELECT somente-leitura no banco do app.

  • rag_search

    Pesquisa arquivos da empresa (governada pelo grupo da chave).

  • rag_list_sources

    Lista as bases de arquivos visíveis para esta chave.

  • list_deployment_history

    Histórico recente (deploy, upgrade, env) sem segredos.

Catálogo (Digital Employees)

  • deploy_service

    Publica um app do catálogo (n8n, nocodb, …) neste time. Exige canDeploy. Não aceita image/price/tenant.

  • get_deployment_access

    URL de login + usuário/senha do app (como o painel Acessos). Exige canDeploy. Avise para não compartilhar.

  • set_instance_env

    Adiciona/atualiza env do app do catálogo e reinicia. Chaves bloqueadas são recusadas. Exige canDeploy.

Apps gerados pelo agente

  • deploy_app

    Publica um app gerado pelo agente a partir do manifesto (upload + build).

  • redeploy_app

    Reconstrói um app custom a partir do source já enviado.

  • get_app_status

    Status de build e runtime de um app custom.

  • get_app_logs

    Logs recentes do build ou do app custom.

  • set_app_env

    Env de um app custom (chaves bloqueadas recusadas).

  • provision_database

    Cria Postgres isolado para o app custom.

  • provision_redis

    Cria Redis privado para o app custom.

  • set_custom_domain

    Domínio próprio — ainda pelo dashboard.

  • open_db_tunnel

    Abre um túnel WireGuard da máquina do usuário até o Postgres de UM app (via VPN do time). Devolve config + installUrl. Exige canDeploy. Redis não entra (hub não encaminha 6379).

  • close_db_tunnel

    Fecha o túnel WireGuard daquele app (remove o peer).

  • check_db_tunnel

    Informa se existe peer de túnel para o app (handshake não verificado pela API).

Ferramentas por serviço

  • n8n_list_workflows, n8n_get_executions, n8n_toggle_workflow (toggle exige canDeploy).
  • chatwoot_list_conversations, chatwoot_get_messages, chatwoot_list_contacts.
  • typebot_list_bots, typebot_get_results, typebot_get_answers.
  • flowise_list_vector_collections.
  • nocodb_list_bases.
  • supabase_list_tables, supabase_query, supabase_list_users.
  • dify_list_apps, dify_list_conversations.
  • penpot_list_projects.
  • ghost_list_posts, ghost_list_members.
  • evolution_list_instances, evolution_instance_status.

Prompt do agente

O arquivo de instruções do agente (custom apps) está em /agent-setup/prompt.md.

Abrir prompt.md
Build 20260926135424