Bienvenido al equipo de Pampling. Esta guía te lleva en 3 pasos a tener tu entorno IA (Claude Code o Codex) configurado para trabajar en Pampling.
Asume que ya tienes Claude Code o Codex instalado. Si no, instálalo primero.
Antes de empezar, identifica en qué situación estás. Tu IA lo usará en el Paso 3 para no romper configuraciones previas:
| Situación | Qué hará tu IA |
|---|---|
| Nuevo desde cero | Crear ficheros de configuración y verificar tokens |
| Ya usas Claude Code o Codex | Revisar tu config existente, decirte qué falta y pedir confirmación antes de tocar nada |
| Ya tienes apps locales | Auditar repos existentes y proponer integración |
| Apps en Vercel u otro sistema | Inventariar deploy actual y proponer migración o coexistencia |
El Wiki MCP es el gateway que permite a tu IA consultar la wiki interna sin tokens ni WebFetch. Hay que registrarlo una sola vez por máquina.
En terminal (PowerShell, CMD o Git Bash):
claude mcp add --scope user --transport http pampling-wiki https://wiki-mcp.pampl.ing/mcp/
--scope user deja el MCP disponible en todos tus proyectos.
Edita ~/.codex/config.toml (haz backup si ya existe) y añade el bloque:
[[mcp_servers]]
name = "pampling-wiki"
url = "https://wiki-mcp.pampl.ing/mcp/"
transport = "streamable-http"
Los MCPs se cargan al iniciar la sesión. Cierra tu IA y vuelve a abrirla.
Dentro de la sesión nueva, escribe:
/mcp
Debería listar pampling-wiki con estado connected. Si aparece pero falla la conexión, revisa que el comando del Paso 1 se ejecutó sin errores y vuelve a reiniciar.
codex mcp list
Debe aparecer pampling-wiki. Si no aparece, revisa el bloque que añadiste a ~/.codex/config.toml.
Una vez Wiki MCP esté conectado, pega este prompt en tu IA:
Configura mi entorno de desarrollo IA para Pampling.
Usa el MCP "pampling-wiki" para leer la página inicio/instrucciones-ia
y sigue el subflujo correspondiente a tu herramienta:
- Claude Code → "Subflujo 1 — Setup automático para Claude Code"
- Codex → "Subflujo 2 — Setup asistido para Codex"
Mi situación actual es: [NUEVO / YA TENGO CLAUDE / YA TENGO CODEX / TENGO APPS LOCALES / APPS EN VERCEL]
Si ya tengo configuración previa, no la sobrescribas: revísala, dime qué
falta y pide confirmación antes de cambiar ficheros.
Al terminar, dame un resumen claro de:
- lo que se ha configurado
- lo que ya existía
- lo que falta que haga yo (aceptar invitaciones, etc.)
Sustituye
[NUEVO / YA TENGO ... ]por tu situación real para que la IA adapte el flujo.
A partir de aquí, tu IA te pedirá las credenciales de Bitbucket y Coolify (ver detalle en Instrucciones IA) y dejará el entorno listo.
Antes de empezar, recuerda esta regla:
| 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 |
Tu IA respeta esto, pero la responsabilidad final es tuya.
C:\Users\USUARIO\
├── .claude\
│ ├── CLAUDE.md ← Credenciales personales (PRIVADO)
│ ├── settings.json ← Permisos
│ └── (.claude.json) ← MCPs registrados (incluye pampling-wiki)
└── repositorio\ ← Directorio de proyectos
C:\Users\USUARIO\
├── .codex\
│ ├── AGENTS.md ← Credenciales personales (PRIVADO)
│ └── config.toml ← Configuración + MCPs
└── repositorio\
Cuando el entorno esté listo, el siguiente paso es crear o auditar aplicaciones siguiendo el workflow create-app, que cubre:
Aplica los Estándares obligatorios de aplicaciones que el agente auditor verifica antes de cada deploy.
| Página | Descripción |
|---|---|
| Instrucciones IA | Lo que tu IA lee y ejecuta en el Paso 3 |
| Plantilla CLAUDE.md | Plantilla personal de Claude Code |
| Plantilla AGENTS.md (Codex) | Plantilla personal de Codex |
| Workflow create-app | Crear o auditar una aplicación |
| Wiki MCP | Documentación del gateway que registras en Paso 1 |
| Estándares de aplicaciones | Criterios obligatorios de seguridad y compliance |
← Home