Postagens

Conecte o Kollabe ao Claude Desktop em 60 segundos: o guia de configuração do MCP

O servidor MCP do Kollabe permite que o Claude Desktop conduza sua daily, abra uma sala de planning poker ou prepare uma retro com os incidentes deste sprint, sem você sair da janela de chat. A configuração é um fluxo OAuth e um trecho de configuração. Eis o processo completo em 60 segundos.

Antes de começar

Você precisa de uma organização Kollabe em um plano pago ou trial, e precisa ser membro dela. Só isso. Sem chaves para gerar, sem infraestrutura para rodar. A conexão emite um token pessoal com escopo em uma organização e dura um ano. Se você ainda não tem uma conta, cadastre-se em kollabe.com e inicie um trial. O servidor MCP fica em https://kollabe.com/api/mcp.

A configuração de 60 segundos

1. Coloque a URL do servidor no seu cliente

   Adicione https://kollabe.com/api/mcp à configuração MCP do seu cliente de IA. Trechos para Claude Desktop, Cursor, Zed e ChatGPT abaixo.

2. Aprove via OAuth

   Reinicie o cliente. Ele abre uma aba do navegador apontando para o SSO do Kollabe. Faça login. O cliente recebe um token automaticamente. Sem copiar e colar.

3. Escolha sua organização na tela de consentimento

   Se você pertence a várias organizações Kollabe, elas aparecerão na tela de consentimento. Escolha aquela em que o assistente deve atuar. Os tokens têm escopo nessa organização e atuam como você.

Esse é o fluxo completo. Abra um novo chat do Claude Desktop e você verá as ferramentas do Kollabe disponíveis.

Trechos de configuração por cliente

Claude Desktop

Edite claude_desktop_config.json (Claude Desktop → Configurações → Desenvolvedor → Editar Config):

{
  "mcpServers": {
    "kollabe": {
      "url": "https://kollabe.com/api/mcp",
      "transport": "http"
    }
  }
}

Reinicie o Claude Desktop. Você receberá uma aba do navegador para o handshake OAuth na primeira conexão.

Cursor

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

{
  "mcpServers": {
    "kollabe": {
      "url": "https://kollabe.com/api/mcp",
      "transport": "http"
    }
  }
}

Zed

Em ~/.config/zed/settings.json, sob a chave context_servers:

{
  "context_servers": {
    "kollabe": {
      "command": {
        "url": "https://kollabe.com/api/mcp",
        "transport": "http"
      }
    }
  }
}

ChatGPT (e outros clientes no estilo conector)

Abra Configurações → Conectores → Adicionar conector personalizado. Cole https://kollabe.com/api/mcp como URL do servidor. Aprove o prompt OAuth da mesma forma que faria para o Notion ou o Google Drive.

Claude Code (CLI)

Se você vive no terminal, registre-o pelo seu shell:

claude mcp add --transport http kollabe https://kollabe.com/api/mcp

O que a tela de consentimento realmente faz

Após o SSO, o Kollabe mostra as organizações às quais você pertence. Organizações elegíveis são clicáveis; organizações no plano gratuito e organizações que ainda não habilitaram o MCP ficam acinzentadas (trial conta como pago). Seu papel na organização escolhida torna-se o papel do assistente. Se você é admin, o assistente pode excluir retros e finalizar rounds. Se você é membro, não pode. Cada conexão gera um token que aparece em Configurações da Organização → Tokens de API, ao lado de quaisquer tokens pessoais que você tenha emitido. Revogue por lá. O token dura um ano e é renovado silenciosamente, então não há nada para rotacionar.

O que se ativa: 46 ferramentas em todo o seu stack

Uma vez conectado, o assistente pode chamar qualquer uma destas. Agrupe por entidade para encontrar o que precisa:

Primeiros prompts para testar

Abra o Claude Desktop e cole qualquer um destes para verificar se está funcionando:

• "Use o Kollabe para me dizer em quais espaços estou e quais retros estão abertas." Teste de fumaça somente leitura, aciona whoami, space_list, retro_list.
• "Olhe meus PRs do GitHub de ontem e rascunhe minha daily do Kollabe para hoje." Combina seus servidores MCP de IDE/git com o standup_submit_answers do Kollabe.
• "Pegue os próximos 10 tickets sem estimativa do Linear e crie uma sala de planning poker chamada 'Sprint 47' com cada um como um round." Aciona planning_poker_create_room e planning_poker_create_rounds_bulk.

A ponte é o ponto: seus outros servidores MCP buscam os dados de origem, o Kollabe conduz a reunião.

Solução de problemas

A aba do navegador nunca abre depois que reinicio o cliente. O registro do servidor MCP é carregado de forma preguiçosa. Abra um novo chat e pergunte qualquer coisa que mencione o Kollabe para acionar o handshake. Minha organização aparece acinzentada na tela de consentimento. Ou ela está no plano gratuito, ou o MCP ainda não foi habilitado. Um proprietário ou super admin precisa ativá-lo em Configurações da Organização. O assistente diz que não tem uma ferramenta para X. Tente o prefixo da entidade (planningpoker, retro*, standup*) para que ele encontre a ferramenta certa. Se uma ferramenta realmente não existir, a API pública cobre alguns endpoints adicionais. Quero desconectar. Configurações da Organização → Tokens de API → Revogar. Toda sessão ativa morre na próxima chamada.

Por que MCP e não apenas uma integração

A maioria das ferramentas ágeis lança um bot do Slack, um plugin do Jira, um conector do Notion e considera o trabalho feito. O MCP comprime esse trabalho em uma única coisa: qualquer cliente que fale o protocolo ganha todas as ferramentas. Hoje isso é Claude Desktop, Cursor, Zed, ChatGPT e Claude Code. No próximo trimestre será o que vier a seguir. Você não escreve código para adicionar uma nova integração. Você adiciona uma linha de configuração. A versão honesta: não sei quais clientes vão importar daqui a um ano. Construir um servidor MCP em vez de cinco SDKs é a aposta de que o protocolo vence, e até agora parece certa.