Claude te hará un par de preguntas, instalará lo que falte y abrirá el navegador para que apruebes el acceso. Solo tienes que seguirle.
Quiero conectar mi Basecamp a Claude Code para que puedas consultar y gestionar mis proyectos. No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir.
CONTEXTO PARA TI
- 37signals publica dos vías oficiales:
1. CLI oficial "basecamp" (la recomendada para Claude Code): cubre toda la API y responde en JSON. Se instala con
curl -fsSL https://basecamp.com/install-cli | bash
o con Homebrew: brew install --cask basecamp/tap/basecamp-cli
El login es OAuth en el navegador (basecamp auth login) y el token se guarda en el llavero del sistema. "basecamp setup claude" instala su plugin para Claude Code (skills y hooks). "basecamp doctor" diagnostica problemas.
2. MCP alojado de 37signals: https://mcp.basecamp.com/mcp, con OAuth. Se añade con
claude mcp add --transport http basecamp https://mcp.basecamp.com/mcp
y se autentica desde /mcp. También funciona en claude.ai y Cowork como conector personalizado.
- La CLI también puede servir de MCP local en solo lectura: basecamp mcp --read-only.
- Otras vías (conectores de terceros como Composio o CData, o la API directa con una app de Launchpad) solo compensan en casos especiales.
- En Windows, la CLI va mejor dentro de WSL2: las versiones antiguas traen un .exe sin firmar que Smart App Control puede bloquear.
QUÉ QUIERO QUE HAGAS
1. ENTENDER: pregúntame, de una en una y con opciones para elegir: si uso Claude solo aquí, en Claude Code, o también en claude.ai o Cowork; y si quiero que solo consultes o también que crees y completes cosas (to-dos, comentarios, mensajes).
2. RECOMENDAR: dime en dos frases qué vía encaja y por qué. Por defecto, la CLI. Si también uso claude.ai o Cowork, el MCP alojado (puede convivir con la CLI).
3. REVISAR: comprueba tú mismo lo que puedas (sistema operativo, si hay Homebrew, si "basecamp" ya está instalado con basecamp --version). Instala lo que falte pidiéndome permiso antes.
4. CONECTAR: lanza el login y dime qué tengo que aprobar en el navegador. Después instala el plugin con basecamp setup claude y avísame si tengo que abrir una sesión nueva para que se cargue.
5. PROBAR: ejecuta basecamp doctor y luego lista mis proyectos (basecamp projects list) para confirmar que funciona. Enséñame un resumen corto.
6. RECORDAR: el plugin ya trae su skill, así que crea una skill personal solo con lo mío: que uso la CLI de Basecamp desde Claude Code, cuál es mi cuenta y lo que vayas aprendiendo. No copies lo que ya trae la del plugin.
Reglas: nunca me pidas la contraseña ni un token en el chat. No publiques, comentes, completes, muevas ni borres nada en Basecamp sin enseñarme antes exactamente qué vas a hacer y esperar mi OK, porque mi equipo lo ve y le llegan notificaciones. Si algo falla, explícamelo en lenguaje sencillo antes de intentar arreglarlo.
CÓMO TRABAJAR CONMIGO
- Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano.
- Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción.
- Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo.
- Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado.
- Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones.
- Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill.
- La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill.
- Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle):
hooks:
Stop:
- hooks:
- type: command
once: true
command: |
grep -q '"stop_hook_active":true' && exit 0
echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'