Conecta tu agente a featury

¿Usas Claude Code o Codex? El plugin de featury hace por ti los pasos 1, 2 y 5 de abajo: conecta tu agente a featury y agrega la skill. No tienes que copiar ninguna clave.

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

En Codex, la última línea inicia tu sesión. En Claude Code, escribe /mcp, elige featury y luego Authenticate. Tu navegador abre featury y tú pulsas Conectar.

Ver el plugin en GitHub

En la app, ve a Cuenta → API keys → Crear API key. La clave completa se muestra solo una vez. Guárdala en un lugar seguro. En el servidor solo se conserva su hash, así que no se puede recuperar después.

Una clave actúa como tú: el agente trabaja con tu identidad y tus permisos exactos en cada workspace al que perteneces, ni más, ni menos. Revoca la clave desde la misma página en cuanto se filtre.

Abrir configuración de cuenta

Apunta tu cliente MCP al endpoint de abajo, con tu clave como token Bearer. Transporte: Streamable HTTP (sin 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"
      }
    }
  }
}

Cada acción de tu agente ocurre en tu cuenta. Featury también muestra QUÉ agente lo hizo: “Claude Code · vía ti” en las líneas de tiempo, comentarios y el tablero.

Vincula un agente a la clave al crearla (Cuenta → Claves API → Crear clave → “Actúa como”): cada llamada con esa clave se atribuye a ese agente, sin configurar el cliente. Esta es la forma recomendada.

¿Prefieres control por petición? Haz que cada cliente envíe el encabezado X-Featury-Agent, como en los ejemplos de arriba. Un encabezado explícito prevalece sobre el vínculo de la clave, así una sola clave puede servir a varios agentes.

Y si no hay nada de eso, featury usa el nombre que el propio cliente informa al conectarse (“claude-code”, “cursor”): la atribución funciona incluso sin configuración.

Las herramientas de descubrimiento (list_workspaces, list_projects) encuentran los slugs de workspace y project por ti; las demás los reciben: los mismos slugs que ves en las URLs de la app.

La skill de featury le enseña a tu agente cuándo usar cada herramienta, cómo hacer el triaje de las solicitudes y cómo dejar en ellas lo que encontró. El plugin de arriba ya la incluye. Sin el plugin, ponla en la carpeta de skills de tu agente:

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

Sirve cualquier directorio de skills que tu agente lea (p. ej. ~/.claude/skills/featury/ para Claude Code). Ver el archivo de la skill

• BUILDING y SHIPPED se derivan de señales reales del código y nunca se pueden fijar a mano: la misma regla que en la app.
• Una señal que sí controlas: cita el refCode de una solicitud en un commit o PR ("Closes idea/dark-mode", "Fixes bug/login-white-screen") y el ticket se entrega automáticamente y avisa a quien lo pidió.
• Las mutaciones se comportan exactamente como las acciones en la app (eventos de recorrido, notificaciones) y se atribuyen a ti.
• ask_featury consume el presupuesto de IA del workspace, como un mensaje de chat en la app.
• Los errores vuelven con un mensaje legible (p. ej. "Workspace not found"). Nunca stack traces.
• ¿Prefieres HTTP puro? Todas las capacidades del MCP también están disponibles en una REST API versionada. Mismas claves, mismos permisos. Docs de la API →