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-9tdrNo Claude
- 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».
- 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).
- 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-9tdrNa 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.
| Ferramenta | Perfis | Recebe | Devolve |
|---|---|---|---|
| server_info | Todos | nada | O produto, seus repositórios, a atualidade da leitura e o que o seu perfil abre. |
| ask_code | Todos, Desenvolvedores, Direção | uma pergunta e, se preciso, «aprofundar», se o seu perfil permitir | Uma 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_changes | Todos, Desenvolvedores, Direção | um número de dias, de 1 a 90, 14 por padrão; se preciso, um repositório | O 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_schema | Direção, Ferramenta de dados | nada | Os conjuntos de estatísticas, a definição de cada medida e a hora do último cálculo. |
| stats_query | Direção, Ferramenta de dados | uma consulta estruturada: conjunto de dados, período, filtros, agrupamentos, medidas, limite | Linhas: 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:
| Pedido | Perfis | Devolve |
|---|---|---|
team_reportperiod_unit, period (opcionais) | Direção | O acompanhamento da equipe em um período. |
developer_profiledeveloper · period_unit, period (opcionais) | Direção | A ficha de um desenvolvedor em um período. |
what_changeddays (opcional, 7 por padrão) | Todos, Desenvolvedores, Direção | O que mudou no produto. |
Ler uma resposta
Cada resposta sobre o código traz um status. É ele que diz se você pode repeti-la.
- Verificado
verified - Confirmado no código. Você pode repetir.
- Somente no servidor
backend_only - O produto sabe fazer, mas nenhuma tela leva a isso.
- Não encontrado
not_found - Procurado sem ser encontrado: muito provavelmente ausente do produto. Não é uma prova.
- Sem conclusão
unknown - 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_schemadiz 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/demoConecte 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.