Início rápido

Existem duas formas de autenticar: um fluxo OAuth de um clique, recomendado, ou uma chave de API manual.

1. Adicione o Vibiz ao seu cliente

Aponte seu cliente MCP para a URL do servidor Vibiz. Isso é toda a informação de que qualquer cliente precisa.

https://mcp.vibiz.ai/mcp

• No Claude, use Settings → Connectors → Add custom connector.
• No Cursor, adicione em Settings → MCP.
• No Claude Code, execute npx @vibiz/vibiz. Ele instala o plugin oficial, com comandos de barra, um subagente e um alerta pós-commit, e a conexão MCP em uma única etapa. Veja a página do Claude Code.

2. Faça login no Vibiz

Seu cliente abre uma aba do navegador para vibiz.ai. Faça login com a mesma conta que você usa no app. Aprove a conexão e o navegador devolve a sessão para o seu cliente.

3. Verifique a conexão

As ferramentas do Vibiz agora devem aparecer no seletor de ferramentas do seu cliente. Tente um prompt como "gere uma imagem de anúncio para o nosso produto principal" para confirmar.

Manual: chave de API

Prefere uma credencial estática? Gere um token na página Developer do seu workspace: faça login em vibiz.ai, depois abra Developer → API keys e adicione-o como um header Bearer. Use isso para agentes sem interface, CI ou clientes que não suportam OAuth.

{
  "mcpServers": {
    "vibiz": {
      "url": "https://mcp.vibiz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VIBIZ_API_KEY"
      }
    }
  }
}

Teste diretamente com curl:

curl https://mcp.vibiz.ai/mcp \
  -H "Authorization: Bearer YOUR_VIBIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Conjuntos de ferramentas (toolsets)

Uma nova conexão carrega o conjunto de ferramentas core: criativos de anúncios, o relatório de crescimento, configuração de marca, cobrança e as principais leituras. Adicione mais anexando ?toolsets= à URL do servidor, ou com o header X-Vibiz-Toolsets em clientes que suportam headers:

https://mcp.vibiz.ai/mcp?toolsets=ads,social
https://mcp.vibiz.ai/mcp?toolsets=all

Conjuntos de ferramentas: core, ads, creatives, social, comms, crm, research, workspace, autonomy, sites. core já lança ou impulsiona anúncios, adiciona anúncios a um conjunto de anúncios existente e define seu orçamento; as outras ferramentas que gastam com anúncios (reativar anúncios, novos conjuntos de anúncios, lançamentos em massa, cópias de campanhas) estão em ads. Todas elas pedem sua aprovação antes de gastar. Adicione readonly=1 para um conector que só pode ler. Não tem certeza de qual precisa? Pergunte ao assistente: a ferramenta vibiz_find_capability encontra qualquer ferramenta e indica o conjunto de ferramentas que a habilita.

Próximos passos