Documentação do Kabo MCP

Início rápido

Conecte em poucos minutos.

O Kabo funciona com clientes que conseguem adicionar um servidor MCP remoto via HTTP e fazer login com OAuth. Os menus mudam de nome, mas os passos são os mesmos.

1. Adicione um servidor remoto

   Abra as configurações de MCP ou de conectores do seu cliente e adicione um servidor com a URL https://kabo.sh/mcp-pub.

2. Entre no Kabo

   Seu cliente abre a página de login do Kabo no navegador. Entre ou crie uma conta, confira o acesso que o Kabo pede e aprove.

3. Confira as ferramentas disponíveis

   Peça ao assistente para chamar get_research_capabilities com um objeto vazio. A resposta mostra quais ferramentas de dados estão prontas para sua conta sem consumir sua cota.

{
  "mcpServers": {
    "kabo": {
      "url": "https://kabo.sh/mcp-pub"
    }
  }
}

Se o seu cliente usa um arquivo JSON, a entrada costuma ser assim. Os nomes dos campos mudam conforme o cliente, então confira a documentação dele.

Skills

Adicione Skills à sua conexão MCP.

Já se conectou? Os dez Skills opcionais do Kabo adicionam fluxos para avaliar contas, pesquisar tendências e concorrentes, analisar vídeos e desenvolver ideias e roteiros. Eles usam sua conexão MCP e seu login do Kabo atuais. Conectar o MCP não os instala automaticamente.

Kabo Skills pode ser usado com agentes compatíveis no seu computador, em espaços de trabalho remotos ou na nuvem. Codex, Claude Code e Cursor são exemplos, não uma lista completa de ambientes compatíveis.

O ambiente do agente precisa carregar SKILL.md e os arquivos incluídos, executar os scripts necessários com Python 3 e usar sua conexão autorizada com o Kabo MCP. A compatibilidade depende dessas capacidades, não de a interface ser um aplicativo desktop ou uma página web.

Repositório oficial e README
https://github.com/kabo-sh/kabo-mcp-plugin

Opção 1: Clone o repositório do GitHub

git clone --branch stable --single-branch https://github.com/kabo-sh/kabo-mcp-plugin.git

Depois de clonar, configure o agente para carregar as pastas completas de Skills de kabo-mcp-plugin/skills/, ou copie ou importe essas pastas para o local de Skills aceito por ele. Preserve todos os scripts, referências e recursos. Clonar por si só não registra os Skills no agente.

Opção 2: Use a skills CLI (npx)

A CLI é uma opção de instalação. Você também pode clonar o repositório do GitHub ou baixar um ZIP. Escolha o método que preferir e que se adapte ao seu ambiente.

npx skills add 'kabo-sh/kabo-mcp-plugin#stable' --skill '*'

Execute este comando no diretório do projeto e escolha seu agente no instalador. Por padrão, a instalação vale para o projeto atual; adicione -g para usar em todos os projetos.

Exemplos de destinos da CLI: --agent codex, --agent claude-code ou --agent cursor. Esses exemplos não limitam quais agentes podem usar Kabo Skills.

Confira a instalação com npx skills list, ou npx skills list -g para uma instalação global. Inicie uma nova sessão do cliente para carregar os Skills.

Opção 3: Baixe um ZIP

O ZIP da versão contém o plugin completo. Para instalar apenas os Skills manualmente, copie cada pasta completa dentro de skills/ para o diretório de Skills do cliente, incluindo scripts, referências e recursos. Copiar apenas SKILL.md não é suficiente. Cópias manuais não são registradas pelo atualizador da CLI.

Versões e atualizações

A branch stable acompanha as versões publicadas. Os Skills instalados não se atualizam em segundo plano. Veja as novas versões e suas notas no GitHub Releases e atualize quando decidir.

git -C kabo-mcp-plugin pull --ff-only

Para um clone da branch stable, execute este comando no diretório que contém kabo-mcp-plugin. Se você copiou ou importou as pastas de Skills para outro local, substitua essas cópias também. O atualizador da skills CLI não acompanha instalações por Git ou ZIP.

Para Skills instalados com a skills CLI, escolha o escopo da atualização:

npx skills update -p

npx skills update -g

Estes comandos atualizam todos os Skills registrados no escopo escolhido, inclusive os de outras fontes. Para atualizar apenas o Kabo, repita o comando de instalação com o mesmo agente e escopo de projeto ou global.

No skills CLI 1.7.4, skills check executa a lógica de atualização e pode substituir arquivos instalados. Consulte a página de versões para saber das novidades sem alterar a instalação.

Troque #stable por #v1.0.1 para fixar essa versão. Atualizar uma instalação fixada não muda para uma tag mais recente; instale a nova tag explicitamente.

Consulte o README para ver os clientes verificados e os requisitos dos fluxos. Uma instalação bem-sucedida não confirma, por si só, um fluxo completo.

Ferramentas

As ferramentas que seu assistente pode usar.

Consulte as ferramentas atuais e seus esquemas de entrada pela solicitação tools/list do cliente. Estes são os principais pontos de partida.

O servidor também oferece ferramentas de dados públicos do YouTube, Instagram e TikTok: perfis, posts, comentários, transcrições, busca e painéis de áudios em alta.

Consulte resultados sem reiniciar o trabalho

Para uma tarefa de dados, envie o job_id para get_research_data_job. Leia os arquivos com read_research_data_artifacts. Para uma análise de vídeo, envie o id recebido para get_analysis_run. Consulte as tarefas pendentes em vez de iniciá-las novamente.

Autenticação

Entre com sua conta do Kabo.

Login: OAuth com PKCE e registro dinâmico de clientes, sem API key para copiar

Recurso OAuth

https://kabo.sh/mcp-pub

Escopos aceitos

offline_accessopenidprofileemaildatavideoworkspace:readworkspace:write

Metadados do servidor:

https://kabo.sh/.well-known/oauth-protected-resource/mcp-pub

O recurso OAuth deve corresponder exatamente ao endpoint acima. Um token emitido para /mcp ou outro endpoint não funciona aqui.

Entre sem navegador

Se o seu cliente MCP roda em um lugar onde não pode abrir um navegador nem receber um redirecionamento OAuth, como um servidor remoto ou um terminal sem interface, ele pode entrar com o fluxo de dispositivo do OAuth (RFC 8628). Use o ID de cliente fixo abaixo. IDs de cliente obtidos pelo registro dinâmico de clientes não são aceitos no login por dispositivo.

ID do cliente

kabo-mcp-pub

Endpoint de autorização de dispositivo

https://kabo.sh/api/auth/device/code

Página de aprovação

https://kabo.sh/device

curl -X POST https://kabo.sh/api/auth/device/code \
  -H 'content-type: application/json' \
  -d '{"client_id":"kabo-mcp-pub","scope":"openid offline_access data video"}'

curl -X POST https://kabo.sh/api/auth/oauth2/token \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d device_code=DEVICE_CODE \
  -d client_id=kabo-mcp-pub

A resposta traz um user_code e um link verification_uri_complete. Abra o link em qualquer dispositivo, entre no Kabo e confira se o código é o mesmo. Enquanto isso, consulte o endpoint de token no intervalo retornado até ele devolver um token de acesso em vez de authorization_pending. O scope precisa incluir offline_access e pode incluir qualquer um dos scopes suportados acima. O token só funciona no endpoint do servidor acima; renove-o com o token de atualização.

O código de dispositivo expira em 15 minutos (expires_in na resposta). Não consulte mais rápido que o interval, que é de 5 segundos; se o servidor retornar slow_down, some 5 segundos. authorization_pending significa continuar consultando com o mesmo código. expired_token significa que o código expirou: solicite um novo. access_denied significa que o usuário recusou: pare e não tente de novo por conta própria. Enquanto um código ainda for válido, não solicite outro: cada solicitação cria um código novo, e só o código que o usuário aprovar faz o login.

O login por dispositivo não usa o parâmetro resource. Tokens emitidos para kabo-mcp-pub ficam sempre vinculados ao endpoint do servidor acima.

Permissões e o que elas liberam

Solicite só o que a tarefa precisa. Cada ferramenta verifica uma permissão e, se ela faltar, retorna 403 insufficient_scope com o nome dela.

offline_access

Necessária para obter um token de atualização. Sem ela, a sessão termina quando o token de acesso de 2 horas expira. Obrigatória no login por dispositivo.

openidprofileemail

Só identidade de login, sem acesso a ferramentas. profile adiciona seu nome e foto, e email adiciona seu e-mail, ao get_kabo_info.

data

Dados públicos de pesquisa: ferramentas de tendências e consulta, jobs de dados de pesquisa e get_research_capabilities.

video

Análise de vídeos salvos e remakes de vídeo. Iniciar uma nova análise exige o Kabo Pro e sua aprovação.

workspace:read

Ler seu espaço de trabalho do Kabo: suas informações do Kabo, contas conectadas, perfil de criador, roteiros e biblioteca de vídeos.

workspace:write

Salvar e atualizar roteiros e conectar contas públicas de criador.

Mantenha a conexão entre tarefas

Tokens de acesso duram 2 horas. Tokens de atualização duram 30 dias e são trocados a cada uso, então cada um funciona uma vez só. Guarde-os no armazenamento seguro de credenciais do host, nunca na conversa nem em logs comuns, e renove de um lugar por vez: reutilizar um token de atualização antigo encerra todas as sessões desse cliente na conta. Terminar uma tarefa não precisa encerrar o login. Se o seu ambiente não consegue guardar credenciais depois de uma tarefa, avise o usuário antes do login que ele vai precisar entrar de novo na próxima vez.

Uso e acesso

A conexão é gratuita. Consultas de dados públicos podem consumir a cota diária da sua conta. Iniciar uma nova análise salva de vídeo requer Kabo Pro e sua aprovação. Consultar disponibilidade e resultados não consome a cota de dados.

O que meu assistente vê pelo Kabo?

As evidências públicas de criadores que o Kabo reúne para o seu pedido, além das análises e pesquisas que você inicia na sua própria conta do Kabo. O Kabo não lê pesquisas de outros usuários nem mensagens privadas, rascunhos ou estatísticas privadas de ninguém.

Não. O Kabo pesquisa e analisa. Ele não publica, não comenta, não envia mensagens nem edita conteúdo em nenhuma plataforma.

Solução de problemas

Resolva os problemas de conexão.

Agentes que se conectam ao Kabo devem seguir estas regras.

1. Verifique antes de fazer login

   Use primeiro a conexão existente e faça login de novo só quando o servidor retornar 401. Para verificar sem usar sua cota, chame get_research_capabilities ou get_kabo_info.

2. Peça o que a tarefa precisa

   Solicite data para dados de pesquisa, video para análise de vídeos salvos e workspace:read ou workspace:write para o espaço de trabalho do Kabo. Não peça todas as permissões por padrão nem deixe de fora uma que a tarefa precise.

3. Ajuste a correção ao erro

   401: faça login. 403 insufficient_scope: autorize de novo com a permissão indicada no erro. invalid_client: confira o ID do cliente. Erros de cota, assinatura, limite de taxa ou concorrência não são problemas de login, então não peça ao usuário para entrar de novo.

4. Depois de um tempo esgotado, verifique antes de repetir

   A solicitação pode já ter sido executada. Confira o resultado primeiro. As ferramentas de salvar e atualizar aceitam uma chave de idempotência, então repetir a mesma solicitação é seguro.

5. Use um único código de dispositivo

   Enquanto um código de dispositivo ainda for válido, continue consultando com ele em vez de solicitar um novo.

6. Skills não são uma conexão

   Ter as Skills do Kabo carregadas não significa que o servidor MCP do Kabo está conectado, e atualizar um plugin não atualiza as ferramentas da sessão atual. Confira se as ferramentas do Kabo aparecem antes de usá-las.