Esta página la lee tu IA (Claude Code, Codex u otra) cuando ha sido invocada desde la Guía de inicio tras registrar el Wiki MCP. Contiene el protocolo completo de auto-setup, las credenciales que necesita pedir, los ficheros que debe generar y los subflujos diferenciados según herramienta.
Si eres un humano: probablemente quieres ir a Guía de inicio — esa página es para ti.
| Situación | Qué debe hacer la IA | Qué debe hacer el usuario |
|---|---|---|
| Nuevo desde cero | Validar herramientas del sistema, crear ficheros de instrucciones, verificar tokens | Obtener accesos a Bitbucket y Coolify |
| Ya usa Claude Code | Revisar ~/.claude/CLAUDE.md, actualizar workflow y verificar credenciales |
Confirmar si sus tokens siguen vigentes |
| Ya usa Codex | Revisar ~/.codex/AGENTS.md, ~/.codex/config.toml y AGENTS.md de proyectos |
Confirmar modo Windows/WSL y permisos |
| Ya tiene apps locales | Auditar repos existentes, detectar stack, generar AGENTS.md/CLAUDE.md de proyecto |
Indicar qué apps quiere migrar o conectar |
| Apps en Vercel/otro sistema | Inventariar deploy actual y proponer migración o coexistencia | Decidir si se migra a Coolify o se mantiene externo |
La IA debe preguntar al usuario en qué situación está antes de tocar nada.
| Tipo de fichero | Dónde vive | Se commitea |
|---|---|---|
| Instrucciones globales | ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md |
❌ Nunca |
| Instrucciones de proyecto | CLAUDE.md, AGENTS.md en raíz del repo |
✅ Sí, sin secretos |
| Credenciales locales | CLAUDE.local.md, AGENTS.local.md, .env |
❌ Gitignored |
Tokens, passwords, connection strings con credenciales: nunca en ficheros que se suben al repo.
Herramientas base que la IA puede instalar/verificar via shell. No incluye Claude Code ni Codex — se asume que ya están instalados (eres tú quien los está usando ahora mismo).
winget install Git.Git
winget install OpenJS.NodeJS.LTS
winget install Python.Python.3.12
git config --global user.name "Tu Nombre"
git config --global user.email "tu.email@pampling.com"
Decisión Windows nativo vs WSL: Codex puede trabajar nativo con PowerShell o en WSL2. Para proyectos en disco Windows, PowerShell nativo suele bastar. Si el proyecto depende de herramientas Linux, usar WSL2 y documentarlo en el setup del proyecto.
Necesitas 2 credenciales. Tu asistente IA te las pedirá durante el setup.
admin:repository:bitbucketread:repository:bitbucketwrite:repository:bitbucketwrite:ssh-key:bitbucketSi no tienes acceso al workspace
pampling, pídeselo ajose.moya@pampling.como a IT antes de generar el token.
El token de Coolify es compartido temporalmente para todo el equipo. Pídeselo directamente a jose.moya@pampling.com.
Mientras tanto, pídele también la invitación a Coolify. Cuando llegue:
http://192.168.1.10:8000, solo red local).Esta sección la lee Claude Code. Asume que partes de cero o quieres reconfigurar tu entorno completo.
Saluda al usuario. Explícale que vas a configurar su entorno y que necesitas 2 credenciales: Bitbucket (email + token) y Coolify (token). Pídelas una a una.
Pregunta al usuario (uno a uno, esperando respuesta):
Ver Paso 2.1 más arriba — pedir email y token. Verificar:
curl -s -u "{BITBUCKET_EMAIL}:{BITBUCKET_TOKEN}" \\
https://api.bitbucket.org/2.0/repositories/pampling?pagelen=1 \\
| python -c "import sys,json; d=json.load(sys.stdin); print('Bitbucket OK -', d.get('size','?'), 'repos')"
Ver Paso 2.2 más arriba — pedir token y, si no la tiene aún, recordar que pida invitación a jose.moya@pampling.com. Verificar:
curl -s -H "Authorization: Bearer {COOLIFY_TOKEN}" \\
http://192.168.1.10:8000/api/v1/applications \\
| python -c "import sys,json; apps=json.load(sys.stdin); print('Coolify OK -', len(apps), 'apps')"
mkdir -p ~/.claude
mkdir -p ~/repositorio
~/.claude/CLAUDE.md ya existe: hacer backup (CLAUDE.md.bak.YYYYMMDD-HHMMSS) y mostrar el diff de lo que vas a cambiar antes de sobrescribir.~/.claude/CLAUDE.md desde la plantilla.~/.claude/create_app.md leyendo Workflow crear app.~/.claude/settings.json con la plantilla del Fichero 3 (más abajo).El Wiki MCP ya quedó registrado en el Paso 1 del prompt inicial. Verificar (la conexión real estará disponible en la próxima sesión):
claude mcp list
Debería aparecer pampling-wiki en la lista.
=== Entorno configurado (Claude Code) ===
Ficheros generados:
~/.claude/CLAUDE.md → Credenciales personales
~/.claude/create_app.md → Workflow para crear/auditar apps
~/.claude/settings.json → Permisos de Claude Code
Tests pasados:
✓ Bitbucket: <N> repos accesibles
✓ Coolify: <N> apps listadas
Cuando quieras crear una app nueva, dime:
"Crea una aplicación nueva llamada NOMBRE"
(seguiré el workflow: https://wiki.pampl.ing/en/workflow/create-app)
Esta sección la lee Codex. No es auto-setup: Codex inspecciona primero, propone cambios y pide confirmación antes de tocar ficheros.
Antes de pedir nada, identificar el entorno:
~/.codex/? ¿Y ~/.claude/?Mostrar al usuario el inventario detectado y preguntar si es correcto.
Inspeccionar (solo lectura):
~/.codex/AGENTS.md — si existe, leer y mostrar resumen~/.codex/config.toml — si existe, leer~/.claude/CLAUDE.md — si existe, solo usarlo como referencia si el usuario lo autoriza explícitamenteMostrar al usuario qué encontró, qué partes están completas y qué falta o está desactualizado.
¿En qué situación estás?
1. Nuevo desde cero (no tengo nada configurado)
2. Ya tengo Codex configurado (revisar y completar)
3. Vengo de Claude Code y quiero usar Codex también
4. Tengo apps locales sin desplegar
5. Tengo apps en Vercel u otro sistema externo
Adaptar el resto del flujo según la respuesta.
No pedir credenciales que ya estén en ~/.codex/AGENTS.md. Si están, verificarlas en silencio antes de pedir nada nuevo. Si faltan, ver Paso 2 más arriba.
# Bitbucket
curl -s -u "{EMAIL}:{TOKEN}" \\
https://api.bitbucket.org/2.0/repositories/pampling?pagelen=1
# Coolify
curl -s -H "Authorization: Bearer {COOLIFY_TOKEN}" \\
http://192.168.1.10:8000/api/v1/applications
# Permisos Bitbucket (solo si va a crear repos)
curl -s -u "{EMAIL}:{TOKEN}" \\
https://api.bitbucket.org/2.0/workspaces/pampling/permissions
Mostrar resultado. Si algo falla, decir qué falla y por qué antes de continuar.
Antes de tocar cada fichero:
fichero.bak.YYYYMMDD-HHMMSS), mostrar el diff propuesto y pedir confirmación.Ficheros a gestionar:
~/.codex/AGENTS.md — desde la plantilla~/.codex/config.toml — solo crear/modificar si es necesario~/.codex/workflows/create_app.md — opcional, copia local del workflow para trabajar offlineEl Wiki MCP ya quedó registrado en el Paso 1 del prompt inicial al añadirse a ~/.codex/config.toml. Verificar:
grep -A3 "pampling-wiki" ~/.codex/config.toml
La conexión real estará disponible en la próxima sesión de Codex.
=== Estado de tu entorno (Codex) ===
Ya existía:
~/.codex/AGENTS.md (actualizado, backup en AGENTS.md.bak.20260504-103000)
Creado nuevo:
~/.codex/config.toml
Tests pasados:
✓ Bitbucket: <N> repos accesibles, permisos OK
✓ Coolify: <N> apps listadas
Falta que tú hagas:
- Aceptar invitación de Coolify si aún no la has aceptado
- Confirmar tokens en password manager
Próximo paso:
- Si tienes apps existentes, dime cuál quieres auditar primero
- Si quieres crear una app nueva, di "crea una app llamada NOMBRE"
(seguiré el workflow: https://wiki.pampl.ing/en/workflow/create-app)
~/.claude/CLAUDE.md (Claude Code)Ver Plantilla CLAUDE.md.
~/.codex/AGENTS.md (Codex)Ver Plantilla AGENTS.md (Codex).
~/.claude/settings.json{
"permissions": {
"allow": [
"Bash(git *)",
"Bash(ssh *)",
"Bash(curl *)",
"Bash(python *)",
"Bash(pip *)",
"Bash(npm *)",
"Bash(node *)",
"Bash(uvicorn *)",
"Bash(docker *)"
]
}
}
~/.codex/config.toml (mínimo)project_doc_max_bytes = 65536
[[mcp_servers]]
name = "pampling-wiki"
url = "https://wiki-mcp.pampl.ing/mcp/"
transport = "streamable-http"
No activar
project_doc_fallback_filenames = ["AGENTS.md", "CLAUDE.md"]. Si Codex lee unCLAUDE.mdajeno puede actuar sobre instrucciones pensadas para Claude Code, no para él. Cada herramienta lee su propio fichero.No guardar tokens dentro de
config.toml. Tokens viven solo en~/.codex/AGENTS.md(privado).
C:\\Users\\USUARIO\\
├── .claude\\
│ ├── CLAUDE.md ← Credenciales personales (PRIVADO)
│ ├── create_app.md ← Workflow
│ ├── settings.json ← Permisos
│ └── (.claude.json) ← MCPs registrados (incluye pampling-wiki)
└── repositorio\\
C:\\Users\\USUARIO\\
├── .codex\\
│ ├── AGENTS.md ← Credenciales personales (PRIVADO)
│ ├── config.toml ← Configuración + MCPs
│ └── workflows\\
│ └── create_app.md ← Opcional, copia local del workflow
└── repositorio\\
Pampling ofrece un MCP server público para que Claude Code, Codex u otra IA consulte la wiki sin tokens ni WebFetch:
URL: https://wiki-mcp.pampl.ing/mcp/
Tu IA debe registrarlo como parte del setup (paso 4.b o 6.b según herramienta). Para apps internas que necesiten leer la wiki en runtime, también hay API REST.
Cuando tengas el entorno listo, el siguiente paso es crear o auditar aplicaciones siguiendo el workflow del equipo:
Define Ruta A (app nueva desde cero) y Ruta B (auditoría de app existente). Y aplica los Estándares obligatorios de aplicaciones que el agente auditor verifica antes de cada deploy.
| Página | Descripción |
|---|---|
| Plantilla CLAUDE.md | Plantilla personal de Claude Code |
| Plantilla AGENTS.md (Codex) | Plantilla personal de Codex |
| Workflow crear app | Crear app nueva o auditar app existente |
| Estándares de aplicaciones | Criterios obligatorios de seguridad y compliance |
| Organización de archivos .md | Jerarquía CLAUDE.md / AGENTS.md por niveles |
| Arquitectura general | Cómo funciona el servidor |
← Home