Velocity

npx add-mcp 'https://velocity.quest/api/mcp'

Servidor MCP

Conecte agentes de IA ao Velocity por meio do Model Context Protocol.

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que agentes de IA interajam com ferramentas externas por meio de uma interface unificada. O Velocity inclui um servidor MCP integrado com 84 ferramentas para rastreamento de issues, PRDs e histórias de usuário, contexto de projeto, eventos de workspace, gerenciamento de workspace e usuários, planejamento de roadmap, domínios personalizados, coordenação de agentes Claude e muito mais.

Agentes de IA como Claude Code, Claude Desktop, Codex, Cursor e outros clientes compatíveis com MCP podem se conectar ao Velocity e criar issues, pesquisar tarefas, atualizar status, gerenciar projetos, planejar roadmaps e configurar domínios — tudo sem sair do seu fluxo de trabalho.

Disponibilidade e acesso

O MCP está disponível para membros atuais de workspaces nos planos Pro, Business ou Enterprise. Workspaces gratuitos não podem usar MCP. Conecte-se por meio de OAuth no navegador ou de um token de conexão de workspace em Settings → MCP. Chaves de API pessoais não podem autenticar o MCP. Consulte configuração e solução de problemas.

A resposta tools/list do servidor conectado é o catálogo atual de ferramentas e entradas. Uma ferramenta listada ainda pode exigir escopo de escrita, uma função de owner/admin, um direito de recurso, configuração de integração ou uma concessão de worker gerenciado. O acesso à ferramenta por si só não inicia um worker nem garante codificação, revisão, merge ou implantação autônomos.

Casos de uso

• Assistentes de codificação com IA — criar relatórios de bugs diretamente a partir de revisões de código
• Triagem automatizada — agentes categorizam e priorizam issues recebidas
• Atualizações de status — agentes atualizam o progresso das issues conforme concluem o trabalho
• Pesquisa e contexto — agentes encontram issues relacionadas para embasar seu trabalho
• Gerenciamento de projetos — agentes leem projetos, ciclos e marcos
• Planejamento de roadmap — agentes gerenciam itens de roadmap, versões e votação
• Gerenciamento de domínios — agentes adicionam e verificam domínios personalizados
• Coordenação de agentes de IA — workers configurados processam issues, vinculam commits e acompanham o progresso da sprint

Ferramentas disponíveis

Estas tabelas são ferramentas selecionadas. A referência de ferramentas também aborda planejamento de PRDs e histórias, anexos privados, eventos de workspace, monitoramento de issues/checks e perfis de entrega. Atualmente, o MCP lê o contexto de projetos/ciclos; use a API GraphQL para criar projetos, ciclos ou marcos de projeto.

PRDs e histórias de usuário

Leia e edite PRDs, requisitos e histórias; divida histórias, vincule issues e crie issues a partir de propostas de histórias revisadas. As ferramentas de proposta de IA exigem mcp:write, o direito correspondente ao plano de IA e créditos disponíveis. As propostas exigem ações separadas de revisão e salvamento; a aprovação humana de PRDs permanece no Velocity. Consulte Da ideia às issues.

Rastreamento de issues

Ferramenta	Escopo	Descrição
list_issues	leitura	Lista issues com filtros por projeto, status, prioridade, responsável, label
get_issue	leitura	Obtém detalhes completos de uma issue por ID ou identificador (ex.: ENG-123)
create_issue	escrita	Cria uma nova issue com título, descrição, prioridade, status
update_issue	escrita	Atualiza os campos de uma issue existente
search_issues	leitura	Pesquisa de texto completo em títulos e descrições de issues
add_comment	escrita	Adiciona um comentário a uma issue
list_comments	leitura	Lista todos os comentários de uma issue

Projetos e ciclos

Ferramenta	Escopo	Descrição
list_projects	leitura	Lista todos os projetos com filtro de status opcional
get_project	leitura	Obtém detalhes do projeto, incluindo marcos e contagem de issues
list_cycles	leitura	Lista ciclos de sprint com filtro de status opcional
get_cycle	leitura	Obtém detalhes do ciclo com contagens de issues e progresso

Metadados do workspace

Ferramenta	Escopo	Descrição
list_teams	leitura	Lista todas as equipes do workspace
list_labels	leitura	Lista todas as labels disponíveis
list_statuses	leitura	Lista todos os status de issues entre as equipes
list_members	leitura	Lista os membros do workspace com suas funções

Roadmap

Ferramenta	Escopo	Descrição
list_roadmap_items	leitura	Lista itens de roadmap com filtros de status, categoria e versão
create_roadmap_item	escrita	Cria um novo item de roadmap
update_roadmap_item	escrita	Atualiza um item de roadmap existente
delete_roadmap_item	escrita	Exclui um item de roadmap
vote_roadmap_item	escrita	Alterna o voto em um item de roadmap
list_roadmap_versions	leitura	Lista todas as versões de roadmap (releases)
create_roadmap_version	escrita	Cria uma nova versão de roadmap
get_roadmap_settings	leitura	Obtém as configurações de visibilidade e votação do roadmap
update_roadmap_settings	escrita	Atualiza as configurações do roadmap

Workspace e usuário

Ferramenta	Escopo	Descrição
list_workspaces	leitura	Lista os workspaces do usuário; OAuth retorna apenas o workspace conectado
create_workspace	escrita	Cria um novo workspace (o usuário se torna owner)
delete_workspace	escrita	Exclui permanentemente um workspace (somente owner)
get_workspace	leitura	Obtém detalhes do workspace atual (nome, plano, número de membros)
update_workspace	escrita	Atualiza o nome do workspace (descrição não é suportada)
get_current_user	leitura	Obtém o perfil do usuário autenticado
update_current_user	escrita	Atualiza o nome de exibição ou avatar do usuário
list_user_api_keys	leitura	Lista chaves de API pessoais (prefixo velu_)
create_user_api_key	escrita	Cria uma chave de API pessoal (retorna a chave uma única vez)
revoke_user_api_key	escrita	Revoga uma chave de API pessoal

Domínios personalizados

Ferramenta	Escopo	Descrição
list_domains	leitura	Lista domínios personalizados com status de verificação
add_domain	escrita	Adiciona um domínio personalizado com instruções de configuração de DNS
verify_domain	escrita	Verifica o status de verificação do domínio
remove_domain	escrita	Remove um domínio personalizado

Fluxo de trabalho do agente

Ferramenta	Escopo	Descrição
transition_issue	escrita	Move a issue para um status por nome (ex.: "In Progress") em vez de UUID
get_my_issues	leitura	Obtém issues atribuídas ao usuário autenticado, filtradas por grupo de status
get_active_sprint	leitura	Obtém o ciclo ativo com contagens de issues e progresso
link_commit	escrita	Registra um SHA de commit em uma issue
link_pr	escrita	Registra uma URL de pull request em uma issue
get_issue_context	leitura	Contexto rico da issue: comentários, atividades, labels, eventos vinculados
get_pending_agent_runs	leitura	Obtém execuções pendentes de API ou Claude Code para um worker local
update_agent_run	escrita	Atualiza o status, os tokens e o resultado de uma execução de agente

Recursos

O servidor MCP também expõe estes recursos somente leitura para contexto rápido:

URI	Descrição
velocity://workspace	Metadados do workspace (nome, slug, plano, contagens de membros/equipes)
velocity://issues	Issues recentes (últimas 20, ordenadas por hora de atualização)
velocity://projects	Todos os projetos com status e progresso
velocity://roadmap	Visão geral de itens de roadmap, versões e configurações
velocity://domains	Domínios personalizados com status de verificação

Limitações de credenciais

Conexões OAuth não podem listar, criar ou revogar chaves de API pessoais, mesmo quando essas ferramentas aparecem no catálogo. Gerencie chaves nas configurações do Velocity ou use um token de conexão para essas ferramentas. Tokens de conexão têm capacidades de conta mais amplas; mantenha-os privados e revogue conexões não utilizadas.

Escopos

As concessões OAuth do MCP usam estes escopos. Tokens de conexão de Settings → MCP incluem ambos:

• mcp:read — Ferramentas e recursos de leitura, sujeitos a restrições de credenciais e recursos
• mcp:write — Ferramentas de escrita, sujeitas a verificações de função, recurso e política de worker (solicite com mcp:read)

Próximos passos

• Configuração e autenticação — faça login ou crie um token de conexão e configure seu cliente
• Referência de ferramentas — documentação detalhada dos parâmetros de cada ferramenta