MCP · Instalação

Conecte seu agente de IA

Cole mcp.busymate.dev uma vez. 454 ferramentas. Sem chaves de API.

Um clique, ou um colar

Pick your client

Cursor e VS Code em um clique. Os demais colam a mesma URL e autorizam no primeiro uso.

Claude Code

Adicione o servidor pelo terminal. A primeira chamada de ferramenta abre o navegador para autorizar.

  1. 01

    Execute o comando abaixo no seu terminal — por padrão ele é adicionado só a este projeto; adicione --scope user para deixá-lo disponível em todos os projetos.

  2. 02

    A primeira chamada de ferramenta abre seu navegador para entrar e autorizar — aprove, e o Claude Code confirma a conexão.

Terminal
bash
# Claude Code — add the server, then authorize in your browser:
claude mcp add --transport http busymate-devtools https://mcp.busymate.dev

Verificar:Execute claude mcp list (ou /mcp dentro do Claude Code) — busymate-devtools aparece como conectado, e todas as 454 ferramentas estarão prontas para uso.

Claude.ai & Claude Desktop

Configurações → Conectores → Adicionar conector personalizado, cole a URL, clique em Conectar e autorize no navegador. Nenhum arquivo para editar.

  1. 01

    Abra Configurações → Conectores, clique em + e escolha Adicionar conector personalizado.

  2. 02

    Cole a URL abaixo como a URL do servidor remoto e clique em Adicionar — deixe os campos de OAuth Client ID/Secret em branco, o Busymate não precisa deles.

  3. 03

    O Claude abre seu navegador para entrar — aprove, e o conector aparece como conectado.

URL do conector
text
https://mcp.busymate.dev

Verificar:Abra o conector de novo — ele lista todas as 454 ferramentas, e o Claude pode chamá-las no meio da conversa.

Cursor
Adicionar ao Cursor

Um clique adiciona e autoriza por OAuth. Ou adicione à mão em ~/.cursor/mcp.json (global) ou num .cursor/mcp.json de projeto:

  1. 01

    Clique em Add to Cursor para instalar com um clique, ou adicione o bloco abaixo manualmente a ~/.cursor/mcp.json (global) ou ao .cursor/mcp.json de um projeto.

  2. 02

    Abra Cursor Settings → MCP e ative o servidor, se ainda não estiver ativado.

  3. 03

    A primeira chamada de ferramenta abre seu navegador para autorizar — o Cursor conclui o handshake OAuth por conta própria, então não há client ID ou secret para colar.

~/.cursor/mcp.json (or .cursor/mcp.json in a project)
json
{
  "mcpServers": {
    "busymate-devtools": {
      "url": "https://mcp.busymate.dev"
    }
  }
}

Verificar:Em Cursor Settings → MCP, o busymate-devtools aparece como ativado, com a contagem de ferramentas ao lado.

VS Code (Copilot)
Instalar no VS Code

Um clique instala no VS Code. Ou adicione à mão num .vscode/mcp.json do workspace (a chave raiz é servers):

  1. 01

    Clique em Install in VS Code para instalar com um clique, ou adicione o bloco abaixo a um .vscode/mcp.json do workspace — ou execute MCP: Open User Configuration para adicioná-lo em todos os workspaces.

  2. 02

    Na primeira vez, o VS Code pede para confiar no servidor — aprove, e depois clique em Start no code lens acima da entrada (ou execute MCP: List Servers na paleta de comandos).

  3. 03

    O VS Code abre seu navegador para o handshake OAuth — entre e aprove.

.vscode/mcp.json (root key: servers)
json
{
  "servers": {
    "busymate-devtools": {
      "type": "http",
      "url": "https://mcp.busymate.dev"
    }
  }
}

Verificar:Execute MCP: List Servers na paleta de comandos — busymate-devtools aparece como Running, com todas as 454 ferramentas listadas.

ChatGPT

Onde conectores em modo desenvolvedor estiverem disponíveis: Configurações → Conectores → Adicionar, cole a URL e autorize. A disponibilidade varia por plano.

  1. 01

    Ative os conectores em modo desenvolvedor — nas configurações do ChatGPT, procure por Developer mode ou Connectors (a localização exata do menu já mudou antes; exige um plano Plus, Pro ou Business ou superior, e um admin do workspace pode restringir isso).

  2. 02

    Adicione um conector personalizado e cole a URL abaixo.

  3. 03

    Autorize na aba do navegador que se abrir.

URL do conector
text
https://mcp.busymate.dev

Verificar:O conector aparece como conectado. Peça ao ChatGPT para usar uma ferramenta do Busymate DevTools e ele deve chamá-la sem erro.

Qualquer outro cliente MCP

O transporte Streamable-HTTP é padrão — Continue, Cline, Zed ou o seu próprio bot usam a mesma configuração. Aponte para a URL:

  1. 01

    Confirme que seu cliente fala o transporte Streamable HTTP (não só stdio) e suporta OAuth 2.1 com Dynamic Client Registration — a maioria dos clientes atuais suporta.

  2. 02

    Aponte-o para a URL abaixo, no formato de configuração que seu cliente espera — o bloco usa a forma comum mcpServers, que a maioria dos clientes lê diretamente.

  3. 03

    Autorize o aviso do navegador no primeiro uso, assim como todos os clientes acima.

mcp.json
json
{
  "mcpServers": {
    "busymate-devtools": {
      "url": "https://mcp.busymate.dev"
    }
  }
}

Verificar:Uma chamada a tools/list retorna todas as 454 ferramentas depois que você autorizar.

The handshake

What happens on first connect

The whole OAuth 2.1 flow, demystified — four steps, all standard, no console to visit first.

  1. 01

    Your client registers itself

    Dynamic Client Registration (RFC 7591): the client POSTs its own metadata and receives a client id. There's nothing to create in a console first.

  2. 02

    You authorize in the browser

    A browser window opens on Busymate's own sign-in. You approve once; PKCE protects the code exchange end to end.

  3. 03

    Tools appear

    The client lists the tools and your agent starts calling them — as you, scoped to your role, with destructive tools confirm-gated.

  4. 04

    The token keeps working

    Refresh rotation keeps the grant alive, and the same token also authenticates REST, WebSockets and Edge Functions. Revoke it any time — every call it made is in your audit trail.

Como fica seguro

Your account, your rules

O acesso é OAuth 2.1 com registro dinâmico de clientes e PKCE — sem chaves coladas, sem segredo compartilhado. O único token que um agente recebe autentica todas as superfícies do Busymate (MCP, REST, WebSockets, Edge Functions) e tem o escopo do seu próprio papel: um agente só pode fazer o que você poderia fazer no painel.

  • com escopo RBAC
  • com confirmação obrigatória
  • segredos ocultados

OAuth 2.1, sem chaves

Registro dinâmico de clientes (RFC 7591) + PKCE (S256) + rotação de refresh. Os usuários autorizam no navegador contra o login do Busymate — não há chave de API para colar ou vazar.

Com o escopo do seu papel

Cada chamada é autorizada pelo próprio banco de dados (RBAC). Ferramentas destrutivas exigem confirmação explícita, e valores secretos nunca são retornados — são somente-escrita e ocultados.

Totalmente auditado

Cada chamada de ferramenta — cada agente, cada ação — cai na trilha de auditoria da sua conta, então você sempre pode ver o que um agente fez em seu nome.

Leia mais: PrivacidadeTermoso modelo de RBAC e trilha de auditoria

As 454 ferramentas

What your agent can drive

Se um humano faz na interface, um agente faz via MCP.

Capture e inspecione tráfego

Busque, inspecione, marque, exporte (HAR), resuma e apague requisições e respostas capturadas — por dispositivo ou na frota inteira.

Controle dispositivos

Liste, renomeie, desparelhe, ligue e desligue a VPN, defina o tipo de conexão ou roteie a saída de um dispositivo por um proxy upstream.

Comande um navegador remoto

Passthrough bruto do Chrome DevTools Protocol — abra, avalie, tire screenshot e capture snapshot do Chrome de um dispositivo conectado.

Automatize farms de celulares

Automação de farms Android e iOS — toque, digite, deslize, instale e gerencie o ciclo de vida de apps, com espelhamento ao vivo.

Roteirize e molde requisições

Scripts de requisição/resposta em sandbox, regras de bloqueio automático, breakpoints e domínios pausados — mute ou sintetize tráfego em voo.

Opere a plataforma

Papéis e capacidades (RBAC), administração de beta TestFlight, cobrança, uma trilha de auditoria consultável, notificações, tarefas, workspaces e a memória de equipe do BusyBro.

Troubleshooting

If something looks stuck

The answers below cover every first-connect snag we've actually seen — most are the protocol working as designed.

The endpoint answers 401 in my browser — is it down?

No — that's the spec working. A bare GET on mcp.busymate.dev returns 401 with the OAuth challenge, because the URL is the OAuth resource identifier your client reads to find the sign-in flow. MCP clients proceed from that challenge automatically.

My client lists the tools but every call fails.

Tool discovery is served before authentication; calling anything requires OAuth. Finish the browser authorization your client started (or trigger it again if the token was revoked), then retry the call.

The browser window never opened.

Most clients also print the authorization URL — copy it into any browser. The flow is a normal web sign-in and hands control back to the client when it finishes.

Should I use mcp.busymate.dev or mcp.busymate.net?

Use mcp.busymate.dev for new configs. The older mcp.busymate.net serves the same server permanently and OAuth issues host-matched metadata on whichever host you connected to — existing setups never break.

Claude Code says the server already exists.

Remove the old entry first — claude mcp remove busymate-devtools — then add it again. Your OAuth grant survives; you won't have to re-authorize.

Do I need separate credentials for a bot and my editor?

No. Each client registers itself and gets its own OAuth grant against your account — individually revocable, all acting under your one role, all visible in the audit trail.

Connect in under a minute

Adicione mcp.busymate.dev, autorize uma vez e chame qualquer uma das 454 ferramentas.

Ask your mate