Conecte seu agente ao featury

Usa o Claude Code ou o Codex? O plugin do featury faz os passos 1, 2 e 5 abaixo por você: conecta seu agente ao featury e instala a skill. Você não precisa copiar nenhuma chave.

claude plugin marketplace add owe-br/plugins
claude plugin install featury@owe-br

codex plugin marketplace add owe-br/plugins
codex plugin add featury@owe-br
codex mcp login featury

No Codex, a última linha faz o login. No Claude Code, digite /mcp, escolha featury e depois Authenticate. O navegador abre o featury, e você clica em Conectar.

Ver o plugin no GitHub

No app, vá em Conta → API keys → Criar API key. A chave completa é mostrada apenas uma vez. Guarde-a em um lugar seguro. No servidor só fica o hash, então ela não pode ser recuperada depois.

Uma chave age como você: o agente trabalha com a sua identidade e exatamente as suas permissões em cada workspace de que você faz parte, nem mais, nem menos. Revogue a chave na mesma página assim que ela vazar.

Abrir configurações da conta

Aponte seu cliente MCP para o endpoint abaixo, com a sua chave como token Bearer. Transporte: Streamable HTTP (sem estado).

https://api.featury.app/mcp

claude mcp add --transport http featury https://api.featury.app/mcp \
  --header "Authorization: Bearer fk_…" \
  --header "X-Featury-Agent: claude-code"

# ~/.codex/config.toml
[mcp_servers.featury]
url = "https://api.featury.app/mcp"
bearer_token_env_var = "FEATURY_API_KEY"
http_headers = { "X-Featury-Agent" = "codex" }

{
  "mcpServers": {
    "featury": {
      "url": "https://api.featury.app/mcp",
      "headers": {
        "Authorization": "Bearer fk_…",
        "X-Featury-Agent": "claude-code"
      }
    }
  }
}

Toda ação do seu agente acontece na sua conta. A featury também mostra QUAL agente fez: “Claude Code · por você” em timelines, comentários e no board.

Vincule um agente à chave na criação (Conta → Chaves de API → Criar chave → “Age como”): toda chamada feita com essa chave é atribuída ao agente, sem nenhuma configuração no cliente. Esta é a forma recomendada.

Prefere controle por requisição? Faça cada cliente enviar o cabeçalho X-Featury-Agent, como nos exemplos acima. Um cabeçalho explícito sobrepõe o vínculo da chave, então uma única chave pode servir vários agentes.

E se nada disso estiver definido, a featury usa o nome que o próprio cliente informa ao conectar (“claude-code”, “cursor”): a atribuição funciona mesmo sem configuração.

As ferramentas de descoberta (list_workspaces, list_projects) encontram os slugs de workspace e project para você; as demais os recebem: os mesmos slugs que você vê nas URLs do app.

A skill do featury ensina seu agente quando usar cada ferramenta, como fazer a triagem dos requests e como registrar neles o que encontrou. O plugin acima já inclui a skill. Sem o plugin, coloque-a na pasta de skills do seu agente:

mkdir -p ~/.agents/skills/featury \
  && curl -fsSL https://featury.app/skill/featury/SKILL.md \
  -o ~/.agents/skills/featury/SKILL.md

Qualquer diretório de skills que o seu agente leia funciona (ex.: ~/.claude/skills/featury/ para o Claude Code). Ver o arquivo da skill

• BUILDING e SHIPPED são derivados de sinais reais do código e nunca podem ser definidos manualmente: a mesma regra do app.
• Um sinal que você controla: cite o refCode de um pedido em um commit ou PR ("Closes idea/dark-mode", "Fixes bug/login-white-screen") e o ticket é entregue automaticamente, avisando quem pediu.
• As mutações se comportam exatamente como as ações no app (eventos de jornada, notificações) e são atribuídas a você.
• ask_featury consome o orçamento de IA do workspace, como uma mensagem de chat no app.
• Os erros voltam com uma mensagem legível (ex.: "Workspace not found"). Nunca stack traces.
• Prefere HTTP puro? Todas as capacidades do MCP também estão disponíveis em uma REST API versionada. Mesmas chaves, mesmas permissões. Docs da API →