Obtén un token de la API de Woodander

Crea un token de acceso personal en los ajustes del Workspace, elige los scopes, pon una caducidad y guárdalo bien. Cada scope explicado.

Un token es la llave que usa tu asistente para hablar con Woodander. Lo creas en tu Workspace, lo copias una vez y lo pegas en tu cliente.

Crea un token #

Inicia sesión y abre el Workspace.
Ve a Settings → API & MCP.
Crea un token: ponle un nombre (por ejemplo "Claude Code portátil"), marca los scopes que necesita y, si quieres, fija una fecha de caducidad.
Cópialo enseguida. Woodander lo muestra una sola vez y guarda solo un hash. Si lo pierdes, revócalo y crea otro.

Los tokens tienen esta pinta: wdr_....

Si no ves la página, o solo ves una invitación a mejorar de plan, tu plan no incluye acceso a la API. Mira Límites y errores.

Scopes: da a cada token solo lo que necesita #

Un scope es un permiso. Un token con read:seo puede leer tus datos SEO y nada más. Marca los mínimos posibles.

Scope	Qué permite
`read:products`	Leer tus proyectos de Discover, sus páginas, leads y reseñas.
`read:analytics`	Leer datos de Google Analytics (GA4) y analíticas de proyecto (vistas, clics, visitantes, leads, referrers).
`read:seo`	Leer tus sitios, datos de Search Console, auditorías, estado de uptime e informes de marca blanca.
`read:media`	Leer tus artículos y borradores, incluido el cuerpo en Markdown.
`read:keywords`	Ideas de palabras clave, palabras clave en seguimiento e historial de posiciones. Es opcional: no viene marcado por defecto.
`read:gtm`	Leer tus contenedores de Google Tag Manager, el análisis de seguimiento, el escaneo del sitio y las solicitudes de cambio.
`write:gtm`	Pedir cambios en Tag Manager: etiquetas, activadores, variables, versiones. En modo Manual se convierten en propuestas. No viene marcado por defecto.
`publish:gtm`	Permite que el token publique una versión de Tag Manager sin ti, pero solo en modo Autonomous. No viene marcado por defecto.
`write:products`	Pedir cambios en tu proyecto de Discover: texto de la página, capturas, Briefs, respuestas a reseñas, estado de leads. No viene marcado por defecto.

Ten en cuenta:

Los scopes de escritura nunca vienen marcados. Los das tú, a propósito.
publish:gtm no hace nada en modo Manual o Hybrid. Ahí publicar siempre espera a que tú lo confirmes. Más en Modos y aprobaciones.
El formulario empieza con los scopes de lectura marcados (proyectos, analítica, SEO, artículos). Palabras clave, Tag Manager y todos los scopes de escritura quedan sin marcar hasta que los marques.
Si solo tienes el pase Project Pro, tus tokens solo pueden llevar read:products, write:products, read:market y write:market. La página muestra solo esos cuatro.
Un scope de lectura no basta para cambiar nada. Un token con solo read:seo no puede tocar Tag Manager.

Elige una caducidad #

La caducidad es opcional, pero nos gusta. Puedes elegir 30, 90, 180 o 365 días, o sin caducidad; viene preseleccionada la de 90 días. Un token para una auditoría puntual puede durar poco; uno en tu portátil, más. Cuando un token caduca, las llamadas devuelven 401 y creas uno nuevo. Puedes tener hasta 20 tokens a la vez.

Comprueba qué puede hacer un token #

Una vez conectado, pídele a tu asistente que llame a whoami. Devuelve el usuario del token, el plan, lo que te queda de cada límite del plan y el nombre, scopes, caducidad y último uso del token.

Revoca un token #

En Settings → API & MCP la lista muestra cada token con la fecha de su último uso. Revócalo ahí y deja de funcionar al instante. Hazlo si pierdes un portátil, si alguien deja el equipo o si pegaste el token en un chat sin querer.

Mantenlo en secreto #

No subas nunca un token a git ni a un repo público.
Guárdalo en la configuración de tu cliente o en una variable de entorno.
Usa un token por herramienta o máquina, así puedes revocar uno sin romper los demás.
No lo pegues en documentos compartidos ni en capturas de pantalla.

Siguiente paso #

Conecta tu cliente: Claude Code, Claude Desktop o Cursor.