Conector MCP.

Opere o Projectura — projetos, tarefas, releases, equipes, documentos — a partir de qualquer LLM/IDE/CLI que fale MCP: Claude Code, Claude Desktop, Codex, Antigravity, Cursor e outras CLIs. Gere um token, cole a config e pronto.

Tutorial de instalação (por plataforma)Guia de automação

Gerar um token

Os tokens de acesso (PAT) ficam nas Configurações do app, em Integrações — gere, liste e revogue por lá, no contexto da sua conta.

Abrir Configurações → Integrações

Conectar — escolha seu cliente

Endpoint https://projectura-next.vercel.app/api/mcp · transport Streamable HTTP. Em qualquer opção, troque pj_SEU_TOKEN pelo token gerado nas Configurações → Integrações.

Claude Code — qualquer pasta, um comando (header nativo):

claude mcp add --transport http projectura https://projectura-next.vercel.app/api/mcp \
  --header "Authorization: Bearer pj_SEU_TOKEN"

Claude Desktop — one-click — baixe o projectura.mcpb, abra no Desktop e cole o PAT no campo. Ou, sem o bundle, via claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "projectura": {
      "command": "npx",
      "args": ["-y", "@projectura/mcp"],
      "env": { "PROJECTURA_TOKEN": "pj_SEU_TOKEN" }
    }
  }
}

Codex — CLI (stdio via @projectura/mcp — escreve em ~/.codex/config.toml):

codex mcp add projectura --env PROJECTURA_TOKEN=pj_SEU_TOKEN -- npx -y @projectura/mcp

Antigravity — “…” no painel do Agent → MCP Servers → Manage → View raw config (~/.gemini/antigravity/mcp_config.json) — usa serverUrl + header:

{
  "mcpServers": {
    "projectura": {
      "serverUrl": "https://projectura-next.vercel.app/api/mcp",
      "headers": { "Authorization": "Bearer pj_SEU_TOKEN" }
    }
  }
}

Cursor / Windsurf — mcp.json (url + header):

{
  "mcpServers": {
    "projectura": {
      "url": "https://projectura-next.vercel.app/api/mcp",
      "headers": { "Authorization": "Bearer pj_SEU_TOKEN" }
    }
  }
}

CLIs / outros clientes MCP — qualquer cliente que fale MCP usa um dos dois caminhos:

# stdio — qualquer cliente MCP (Gemini CLI, opencode, etc.): command/args/env
npx -y @projectura/mcp      # com env PROJECTURA_TOKEN=pj_SEU_TOKEN

# HTTP direto — aponte para a URL com o header Authorization:
https://projectura-next.vercel.app/api/mcp   ·   Authorization: Bearer pj_SEU_TOKEN

Sem token válido o endpoint responde 401. O caminho stdio (Claude Desktop / Codex via @projectura/mcp) precisa de Node/npx na máquina; Claude Code, Antigravity e Cursor falam HTTP direto. Passo a passo no guia de automação →.

O que dá para fazer

37 tools projectura_*. Detalhes na guia de automação.

Contextocontext · list_workspaces

Projetoslist · get · create · update · delete · set_repos

Tarefaslist · get · create · update · move · delete · add_comment · log_time · add_subtask

Releaseslist · get · create · update · delete · link_task

Equipeslist · get · create · update · delete · add_member · remove_member

Documentoslist · get · create · update · delete

Notificaçõeslist · unread_count

Skills prontas (Claude)

7 fluxos prontos — criar tarefas, abrir release, triar inbox, status report, lançar horas, docs, planejar sprint — como pacote de skills para Claude Code/Desktop. Usam as tools acima; o pré-requisito é o conector MCP conectado. Instale com um comando:

# Claude Code — marketplace (instala as 7 skills):
/plugin marketplace add odevmaismais/projectura-skills
/plugin install projectura@projectura

# ou via npm (copia p/ ~/.claude/skills + ~/.agents/skills → Codex, Gemini CLI, opencode):
npx @projectura/skills

SKILL.md é padrão aberto — as mesmas skills rodam também em Codex, Gemini CLI, opencode e Antigravity (cada um com seu método de install). Passo a passo por plataforma no tutorial de instalação · código em skills/.