Documentação: conectar o DeployIt ao seu Claude

Todo o DeployIt cabe em uma página: conectar, cinco ferramentas e como ler uma resposta.

Conectar

Seu administrador deu a você o link da sua empresa. Ele se parece com isto:

https://mcp.deployit.ai/acme/k7mq-x2pf-9tdr

No Claude

  1. Abra Personalizar, depois Conectores, e adicione um conector personalizado. Em uma conta Team ou Enterprise, um proprietário o adiciona uma vez para toda a organização, em Configurações da organização, depois Conectores; depois cada pessoa clica em «Conectar».
  2. Cole o link. O Claude abre uma página do DeployIt (em inglês, francês ou espanhol): informe seu nome e seu e-mail (o endereço não é verificado).
  3. Pronto. Faça uma pergunta: «O que você sabe sobre este produto?»

No Claude Code

claude mcp add --transport http deployit https://mcp.deployit.ai/acme/k7mq-x2pf-9tdr

Na primeira pergunta, o Claude Code abre a mesma página de cadastro.

Login automático (beta, sob pedido)

Se a sua organização Claude gerencia os logins pelo provedor de identidade, o login automático pode cadastrar você sem digitar nada. Ele está em beta, sob pedido: o seu administrador do DeployIt nos escreve para abri-lo. O seu endereço é então atestado quando o emissor é o Claude ou quando o seu provedor de identidade o marca como verificado; caso contrário, continua declarado.

Para o administrador

  • Na configuração do login automático da sua organização Claude, preencha sempre «Tenant ID» com o identificador da sua empresa no DeployIt (a parte do seu link que vem depois de mcp.deployit.ai/): somente a sua empresa recebe então as suas asserções.
  • Uma vez ligado o login automático, o identificador da sua empresa não muda mais.
  • Um perfil que você atribuiu de antemão a um endereço só é dado a um endereço atestado: o emissor é o Claude, ou o seu provedor de identidade marca o endereço como verificado. Caso contrário, a pessoa entra com «Todos».
  • Uma pessoa que você removeu não volta pelo login automático.

O DeployIt é um servidor MCP em HTTP, com uma autorização OAuth aberta ao Claude (web e desktop) e aos clientes locais como o Claude Code. Os outros clientes web não podem se cadastrar, e Cursor ou Windsurf ainda não podem.

Um endereço antigo com chave responde «este link mudou»: peça o link da sua empresa ao seu administrador.

As cinco ferramentas

Você não precisa chamá-las: o assistente escolhe. Nenhuma altera os seus repositórios nem as suas configurações; cada chamada é registrada no registro da sua empresa; uma ferramenta da sua empresa que você abre ao agente age com os próprios direitos.

FerramentaPerfisRecebeDevolve
server_infoTodosnadaO produto, seus repositórios, a atualidade da leitura e o que o seu perfil abre.
ask_codeTodos, Desenvolvedores, Direçãouma pergunta e, se preciso, «aprofundar», se o seu perfil permitirUma resposta, seu status e o que foi consultado. De 20 a 60 segundos na primeira vez; imediato depois para a mesma pergunta nos mesmos termos e sem contexto, enquanto o código não mudar.
recent_changesTodos, Desenvolvedores, Direçãoum número de dias, de 1 a 90, 14 por padrão; se preciso, um repositórioO que chegou ao branch acompanhado, agrupado em entregas (por PR, ou por dia, módulo e tipo): data, tipo, título, módulos, número de commits; sem nome de pessoa. Imediato.
stats_schemaDireção, Ferramenta de dadosnadaOs conjuntos de estatísticas, a definição de cada medida e a hora do último cálculo.
stats_queryDireção, Ferramenta de dadosuma consulta estruturada: conjunto de dados, período, filtros, agrupamentos, medidas, limiteLinhas: por equipe ou por desenvolvedor, por mês, trimestre, semestre ou ano.

O servidor também oferece três pedidos prontos para uso, para que a mesma tabela volte idêntica de um mês para o outro:

PedidoPerfisDevolve
team_reportperiod_unit, period (opcionais)DireçãoO acompanhamento da equipe em um período.
developer_profiledeveloper · period_unit, period (opcionais)DireçãoA ficha de um desenvolvedor em um período.
what_changeddays (opcional, 7 por padrão)Todos, Desenvolvedores, DireçãoO que mudou no produto.

Ler uma resposta

Cada resposta sobre o código traz um status. É ele que diz se você pode repeti-la.

Verificadoverified
Confirmado no código. Você pode repetir.
Somente no servidorbackend_only
O produto sabe fazer, mas nenhuma tela leva a isso.
Não encontradonot_found
Procurado sem ser encontrado: muito provavelmente ausente do produto. Não é uma prova.
Sem conclusãounknown
A investigação não chegou a um resultado. Não a repita como um fato; refaça a pergunta com «aprofundar», se o seu perfil permitir.

Quando o DeployIt não responde

  • Seu acesso foi removido por um administrador.
  • O assunto é um dos que a sua empresa recusou.
  • Seu limite mensal de perguntas foi atingido (o perfil «Todos» tem um por padrão).
  • A sua empresa atingiu o volume mensal de perguntas previsto pelo seu plano: o contador recomeça no mês seguinte.
  • O plano gratuito usou as suas 15 perguntas da semana: elas voltam na segunda-feira.
  • Sem plano nem teste, o perfil «Direção» não vê as ferramentas de estatísticas, e uma chave de ferramenta de dados recebe uma recusa.

Cada recusa é dita com clareza ao seu assistente, que a repete para você.

As estatísticas

Fatos escritos uma vez por commit integrado, atualizados toda noite. Cada linha se liga aos seus commits.

Os conjuntos de dados

commits
Um commit integrado: seu autor, sua data de chegada, sua PR, seus testes, seu ticket, seu módulo, sua nota e seus cinco critérios.
pull_requests
Uma PR: quem a abriu, quem a revisou (um colega, não o seu autor nem um robô), em quanto tempo.
reviews
Uma revisão: quem revisou qual PR, se é um colega do autor, e seu veredito (aprovada, mudanças solicitadas; no GitLab, apenas as aprovações).
defects
Um defeito: o commit de origem, sua correção, quem corrigiu, e se está «confirmado» ou «a confirmar».
people
Uma pessoa acompanhada, ou um agente de código: suas identidades, seu papel, seu tempo de trabalho, se é um prestador externo.
absences
Os períodos de ausência declarados para uma pessoa, para ler sua atividade sem falsas quedas.
repositories
Os repositórios cobertos, seu branch de destino, desde quando seu histórico é lido e a hora do último cálculo.
module_ownership
Quem escreveu cada módulo nos últimos 12 meses, para ver os que dependem de uma só pessoa.
person_period, team_period
As sínteses por desenvolvedor e por equipe, por mês, trimestre, semestre ou ano.

As colunas de cada conjunto, a definição de cada medida e os limites são lidos com a ferramenta stats_schema: ela é a referência.

As regras de leitura

  • A nota do código é uma média: ela é sempre devolvida com o número de commits que resume.
  • Um defeito se revela depois: os últimos 60 dias ainda não estão maduros, e a ferramenta stats_schema diz isso.
  • Um período encerrado ainda pode mudar (um commit chegado tarde, duas identidades unidas, um defeito descartado): cada síntese traz a hora do seu último cálculo.
  • Só conta o trabalho que chega ao branch de destino de cada repositório, e ele conta na chegada: um commit datado antes mas integrado neste mês conta para este mês. Os robôs são excluídos; os agentes de código detectados são contados à parte; um agente não declarado conta como trabalho humano.

Conectar uma ferramenta de dados

Um data warehouse ou uma ferramenta de BI não se cadastra: ele apresenta uma chave de «Ferramenta de dados», criada por um administrador e mostrada uma única vez, em um cabeçalho.

POST https://mcp.deployit.ai/acme
Authorization: Bearer dpk_…

Ela chama stats_query e segue o cursor para ler todas as linhas. Um commit pode mudar depois (um defeito se revela em até 60 dias): releia pelo menos os últimos 60 dias a cada passagem. A chave não abre nenhuma pergunta sobre o código.

Limites

  • 120 chamadas por minuto e por pessoa; 600 por minuto para uma chave de ferramenta de dados.
  • A espera é limitada a um minuto; depois, a investigação continua em segundo plano: refaça a mesma pergunta um pouco mais tarde, com as mesmas palavras e sem contexto.
  • Plano gratuito: 15 perguntas sobre o código por semana para toda a empresa, de segunda a domingo. Uma resposta já conhecida não conta.
  • Em um plano, as perguntas estão incluídas dentro de um uso normal, exibido no seu espaço. O perfil «Todos» tem por padrão um limite de 40 perguntas por mês por pessoa; o administrador ajusta esse limite, perfil por perfil. Atingido o limite, as respostas já conhecidas continuam sendo servidas.
  • Uma consulta de estatísticas devolve no máximo 5.000 linhas (500 para o perfil Direção) e responde em no máximo 10 segundos; acima disso, siga o cursor ou divida por período.
  • A demonstração responde com o perfil «Todos», sem estatísticas, e limita o número de perguntas por endereço.

Endereço da demonstração:

https://mcp.deployit.ai/demo

Conecte seu código e faça sua primeira pergunta

30 dias de teste, sem cartão de crédito. O DeployIt lê seus repositórios: nenhum commit, nenhum branch, nenhuma PR.