Conectar o Cursor a um Quadro de Projeto Ao Vivo sobre MCP Hospedado (HTTP Streamable)

Eu sou Soheil Saheb-Jamii (Anymfah). Eu construí a superfície MCP da Stellary para que um host de IA converse com o mesmo backend NestJS que o aplicativo — não é um wrapper de brinquedo e não é um processo stdio local que você precisa cuidar.

Este post é um guia de configuração. Ao final, você deve ter o endpoint em seu cliente, uma credencial somente leitura e uma chamada list_projects bem-sucedida.

O que ele faz dentro do Cursor / Claude Desktop

Uma vez conectado, o host vê as ferramentas da Stellary da mesma forma que vê qualquer outro servidor MCP. Loop típico do Agente:

• Descobrir quais projetos você pode acessar
• Puxar cartões para um ID de projeto
• Ler sinais de cockpit / pilotagem para o espaço de trabalho
• Opcionalmente criar ou mover cartões, ou reivindicar missões de agente em fila

Sem daemon separado. Nenhum pacote npx. O transporte é HTTP Streamable hospedado em:

https://api.stellary.co/mcp

GET é útil para descoberta / negociação; POST carrega solicitações MCP. O servidor cria um transporte novo por solicitação, então clientes que não persistem Mcp-Session-Id ainda funcionam.

Adicione o servidor (copiar-colar)

Prefira OAuth quando o cliente suportar. Em configurações estilo Cursor ou Claude Desktop, apenas a URL é suficiente — o cliente descobre a Stellary, abre o consentimento e armazena tokens. Nenhum PAT no arquivo.

Coloque isso em ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto), ou na interface de configurações MCP equivalente. Reinicie / recarregue as ferramentas MCP até que stellary apareça como conectado.

Fallback de PAT (sem OAuth ainda)

Se seu cliente não conseguir completar o OAuth, crie um token de acesso pessoal em app.stellary.co nas configurações da conta → tokens de API. Comece com:

• projects:read — quadros, cartões, documentos, contexto do projeto
• pilotage:read — sinais de cockpit e direção

Um PAT atua como você (o humano). A adesão ao espaço de trabalho e o acesso ao projeto ainda se aplicam a cada chamada. Adicione escopos de gravação somente após o caminho de leitura funcionar.

Coloque o segredo em uma variável de ambiente — nunca cole um token bruto no artigo, git ou um gist compartilhado:

{
  "mcpServers": {
    "stellary": {
Export `STELLARY_TOKEN` em o ambiente que inicia o IDE / host MCP. Revogue o token se ele vazar.

## Primeiras verificações

Peça ao agente (ou chame ferramentas manualmente) nesta ordem. Permaneça somente em leituras até que os IDs pareçam corretos.
1. **`list_projects`** — confirme que o espaço de trabalho e a lista de projetos correspondem ao que você vê no aplicativo.
2. **`list_cards`** (ou `get_project_details`) com um **ID de projeto exato** do passo 1 — o matching de nome fuzzy existe, mas IDs são mais seguros.
3. **Cockpit** — `get_cockpit_dashboard` ou `get_pilotage_state` com `pilotage:read` — sprint / sinais de direção sem abrir o a ...