API

MCP server

Iterar expone un servidor MCP (Model Context Protocol) para que Claude Code / Claude Desktop hablen directamente con tu roadmap: listar items, leer el contexto completo para armar un PRD, mover estados y publicar changelog.

1. Generar una API key

Andá a /dashboard/api-keys y creá una key. Las keys empiezan con lpbk_sk_ y solo se muestran una vez — guardalas en un password manager.

No las publiques

Estas keys dan acceso de lectura+escritura a tus proyectos. Nunca las commitees a un repo. Si una se filtra, revocala desde el dashboard.

2. Configurar Claude Desktop

Abrí ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o el equivalente en Windows y agregá el bloque iterar:

claude_desktop_config.json

json

{
  "mcpServers": {
    "iterar": {
      "command": "npx",
      "args": ["-y", "@loopback/mcp"],
      "env": {
        "ITERAR_API_KEY": "lpbk_sk_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Reiniciá Claude Desktop. Vas a ver el servidor iterar en la barra inferior con las tools disponibles.

Alternativa: HTTP/SSE remoto

Si preferís no usar npx, usamos transport HTTP/SSE en mcp.iterar.io/sse:

claude_desktop_config.json (HTTP)

json

{
  "mcpServers": {
    "iterar": {
      "url": "https://mcp.iterar.io/sse",
      "headers": {
        "Authorization": "Bearer lpbk_sk_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

3. Tools disponibles

Tool	Input	Output
list_projects	—	Lista de proyectos del owner
list_roadmap_items	project_id, status?, limit?	Items del roadmap
get_item_details	item_id	Item + comments + quotes
get_top_requests	project_id, limit?, period?	Top votados
update_item_status	item_id, new_status	Item actualizado
post_internal_note	item_id, note	Comment creado
mark_item_completed_and_announce	item_id, changelog_body?	Item completed + entry
create_changelog_entry	project_id, title, body…	Entry creada
list_changelog_entries	project_id, since?	Entradas
update_changelog_entry	entry_id, …	Entry actualizada
get_credits_balance	—	{ plan, extra }

4. Ejemplo de conversación

claude code session

bash

> Mostrame el top 5 del roadmap de Fixie
[Claude llama list_projects → get_top_requests("fixie", limit=5)]

> Traete los detalles del item más votado y armá un PRD en /docs/
[Claude llama get_item_details(item_id) → lee título, descripción, quotes]
[Claude redacta el PRD él mismo y lo guarda en /docs/prd-export-pdf.md]

> Cuando termines, marcalo como completed y avisá en el changelog
[Claude llama mark_item_completed_and_announce(item_id, changelog_body)]

Comportamiento por plan

Free: MCP deshabilitado.
Starter / Pro / Studio: MCP habilitado, sin límite de calls de lectura.
Todas las tools del MCP son gratuitas. Los créditos se consumen únicamente al procesar feedback recibido por el widget (1 crédito por feedback procesado).

Troubleshooting

«Server not connecting»: verificá que la API key sea válida (lpbk_sk_) y que tu Node ≥ 18.
«Tool not found»: reiniciá Claude Desktop después de cambiar la config.