Stellary

Servidor MCP de Gerenciamento de Projetos Stellary

Conecte assistentes de IA e agentes de codificação a projetos Stellary ativos por meio do Model Context Protocol (MCP). O servidor hospedado expõe ferramentas de projeto, quadro, colaboração, cockpit e missões de agente, preservando as permissões existentes do Stellary.

• Endpoint: https://api.stellary.co/mcp
• Transporte: HTTP Streamable
• Autenticação: OAuth 2.1 com PKCE e rotação de refresh token; PATs Bearer permanecem suportados para compatibilidade

Listagem oficial no MCP Registry · Documentação · Guia em francês

O que você pode fazer

• Descobrir projetos, colunas, cartões, documentos e estado do cockpit.
• Criar e atualizar cartões, mover trabalho, atribuir colegas de equipe e adicionar comentários.
• Inspecionar sprints, prioridades, status de agentes e propostas pendentes.
• Executar missões de agentes governadas com regras de workspace e políticas de aprovação.
• Usar integrações de workspace instaladas em sessões de agentes elegíveis.

Uma conexão OAuth pode autorizar Eu, um ou mais agentes ativos do workspace, ou ambos. A lista exata de ferramentas é resolvida no momento da conexão e verificada novamente para a identidade selecionada em cada chamada. Ela depende dos escopos OAuth, acesso a projetos, configuração do workspace e das políticas de ferramentas e autonomia de cada agente.

Conecte-se em três etapas

1. Adicione o endpoint hospedado a um cliente MCP compatível com OAuth.
2. Entre no Stellary na janela do navegador aberta pelo cliente.
3. Escolha um workspace e autorize Eu, um ou mais agentes ativos, ou ambos.

Claude Code

claude mcp add stellary \
  --transport streamable-http \
  https://api.stellary.co/mcp

Cursor e clientes baseados em JSON

{
  "mcpServers": {
    "stellary": {
      "url": "https://api.stellary.co/mcp"
    }
  }
}

Um exemplo reutilizável está disponível em examples/mcp-client.json. Instalação pelo Marketplace e escopos de fallback PAT estão documentados abaixo.

Instalar a partir do Cursor Marketplace

Este repositório é o wrapper do Plugin Cursor para o endpoint HTTP Streamable hospedado. Ele não inicia um servidor local stdio ou npx.

1. Abra Customize no Cursor e instale Stellary a partir do Cursor Marketplace assim que a listagem estiver disponível (submissão: formulário de publicação).
2. Conclua a janela OAuth do Stellary. Escolha um workspace e autorize Eu, um ou mais agentes ativos, ou ambos.
3. Peça ao Cursor para listar seus projetos Stellary.

Até que a listagem seja pública, crie um symlink deste repositório em ~/.cursor/plugins/local/stellary ou adicione a mesma URL hospedada às configurações MCP do Cursor / ~/.cursor/mcp.json:

{
  "mcpServers": {
    "stellary": {
      "url": "https://api.stellary.co/mcp"
    }
  }
}

O Cursor descobre o OAuth a partir dos metadados do Stellary. O pacote do Marketplace, portanto, envia sem cabeçalho Bearer e sem placeholder ${STELLARY_TOKEN}.

PAT de compatibilidade (somente se o OAuth não puder ser concluído)

Crie um token dedicado em Configurações da conta → Tokens de API. Comece com projects:read e pilotage:read. Adicione escopos de escrita somente quando o cliente precisar deles. Mantenha o segredo nas configurações MCP do usuário — nunca neste repositório:

{
  "mcpServers": {
    "stellary": {
      "url": "https://api.stellary.co/mcp",
      "headers": {
        "Authorization": "Bearer ${env:STELLARY_TOKEN}"
      }
    }
  }
}

A lista de verificação de publicação para marketplace-publishing@cursor.com / o formulário de publicação está em CURSOR_SUBMISSION.md.

Primeira solicitação recomendada

Peça ao cliente para listar seus projetos Stellary. Isso confirma a autenticação e a visibilidade dos projetos sem alterar dados. Em seguida, peça para inspecionar as colunas e cartões de um projeto antes de habilitar escopos de escrita.

Segurança

• Revogue uma conexão OAuth em Configurações do workspace → Conexões MCP quando um cliente não deve mais ter acesso.
• Trate PATs de compatibilidade como senhas e nunca os envie para um repositório.
• Comece com escopos somente leitura e use uma data de expiração quando um PAT for necessário.
• Todas as solicitações ainda estão sujeitas às permissões e limites de taxa do Stellary.
• O Stellary nunca envia ao cliente os tokens privados anexados aos seus agentes.

Para vulnerabilidades, siga SECURITY.md. Para dúvidas de configuração, envie um e-mail para support@stellary.co.

Manifestos do diretório de agentes

Este repositório também é a fonte pública de descoberta para diretórios de plugins de agentes. Superfícies compatíveis com OAuth apontam para o endpoint HTTP Streamable hospedado sem incorporar um segredo. A configuração legada de PAT permanece documentada para clientes que não podem concluir o OAuth remoto. Nenhum inicia um servidor local stdio/npx.

Superfície	Arquivos
cursor.directory / Open Plugins	.mcp.json
Cursor Marketplace	.cursor-plugin/plugin.json, mcp.json, skills/stellary/SKILL.md, CURSOR_SUBMISSION.md
Claude Code Plugin Directory	.claude-plugin/plugin.json, .claude-plugin/marketplace.json, .mcp.json
Gemini CLI Extensions	gemini-extension.json
skills.sh / ClawHub	SKILL.md (npx skills add Anymfah/stellary-mcp)
Grok Build	.grok-plugin/plugin.json
GitHub Copilot / Agent Plugins	plugin.json
OpenAI Plugins / Codex	plugins/stellary/.codex-plugin/plugin.json, plugins/stellary/.mcp.json

Defina STELLARY_TOKEN somente quando um cliente não puder usar OAuth. Nunca envie um token real. Um ícone de listagem 400×400 está em assets/logo-400.png.

Sobre este repositório

Este repositório público é a fonte canônica de descoberta e configuração para o servidor MCP hospedado do Stellary. Ele contém o manifesto oficial do MCP Registry, exemplos de clientes, documentação e verificações automatizadas de disponibilidade. O aplicativo Stellary hospedado e a implementação do servidor não são distribuídos a partir deste repositório.

Manifestos finos de plugins para Grok Build e GitHub Copilot estão em .mcp.json, .grok-plugin/plugin.json e plugin.json. Eles apontam para o endpoint hospedado https://api.stellary.co/mcp (HTTP Streamable com OAuth, além de compatibilidade com PAT). Um ícone de listagem 400×400 está em assets/logo-400.png.

Os metadados e a documentação neste repositório são licenciados sob a Licença MIT. O uso do serviço hospedado é regido pelos termos do Stellary.