---
title: "Desarrolla con Claude Code, Codex o Cursor"
description: "Instala las habilidades de agente de ThunderPhone, conecta el servidor MCP de ThunderPhone y proporciona a un agente de programación documentación actualizada del producto."
---

ThunderPhone proporciona tres capas para agentes de programación:

| Capa | Lo que proporciona al agente |
| --- | --- |
| [Habilidades de agentes](https://github.com/thunderphone/skills) | Procedimientos específicos para agentes, prompts, números, llamadas, herramientas, webhooks, conocimiento, pruebas, campañas, widgets, plataformas en tiempo real y migraciones. |
| MCP | Las herramientas autenticadas incluyen agentes, números, llamadas, pruebas, conocimiento, herramientas/webhooks, campañas, voces, importaciones y documentación a medida que se incorporan; llama a `tools/list` para consultar el catálogo actualizado. |
| [Documentación sin procesar](https://thunderphone.com/docs/llms.txt) | Fuentes actuales de Markdown sobre el comportamiento del producto y los detalles de la API. |

Las habilidades explican cómo realizar el trabajo. MCP permite que el agente de programación inspeccione y actúe en tu organización. La documentación sin procesar proporciona el material fuente para preguntas que no están cubiertas por una habilidad cargada.

## Instalar en un proyecto

Este bloque instala las habilidades, hace que la clave esté disponible para la shell actual y agrega el servidor MCP con alcance de proyecto a Claude Code. Reemplaza el marcador de posición leyendo el valor real desde tu administrador de secretos; no pegues una clave en un repositorio ni en un chat.

```bash
npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
  --header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
  thunderphone https://api.thunderphone.com/v1/mcp
```

Para Codex, reemplaza el comando final por:

```bash
codex mcp add thunderphone \
  --url https://api.thunderphone.com/v1/mcp \
  --bearer-token-env-var THUNDERPHONE_API_KEY
```

Cursor lee una configuración de proyecto desde `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

VS Code usa el mismo servidor bajo una clave `servers` en `.vscode/mcp.json`:

```json
{
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

<Warning>
  Una clave de API de organización puede leer datos de la organización y realizar
  acciones habilitadas. Guárdala en un administrador de secretos, limita el acceso al proyecto previsto
  y revisa las llamadas a herramientas que realizan cambios antes de aprobarlas.
</Warning>

## Sesión de ejemplo: recepcionista dental bilingüe

1. Pide al agente de programación que cargue `create-agent`,
   `thunderphone-prompt-builder`, `build-tool-integration`, `add-knowledge` y
   `test-agent`. Indícale que primero planifique y que aún no cree recursos.
2. Proporciónale datos verificados del consultorio, tareas compatibles, reglas de escalamiento y las
   dos configuraciones regionales requeridas. Pídele que consulte el catálogo de voces en tiempo real y los
   idiomas compatibles en lugar de inventar una voz o configuración regional.
3. Solicita un prompt de producción basado en principios generales y datos. El
   agente debe cambiar al idioma compatible de quien llama, mantener el habla concisa,
   hacer una pregunta a la vez y evitar guiones de respuestas de quienes llaman.
4. Pídele que defina una herramienta de programación limitada y adjunte solo el conocimiento que la
   recepcionista necesita. Prueba el éxito de la herramienta, la falta de disponibilidad, entradas no válidas,
   tiempos de espera y la transferencia a una persona antes de implementar.
5. Genera escenarios para ambos idiomas, interrupciones, correcciones, información faltante,
   preguntas de conocimiento, fallas de programación y escalamiento. Ejecútalos, revisa las transcripciones y la
   evidencia de las herramientas, corrige la regla general más pequeña y vuelve a ejecutar el mismo conjunto.
6. Revisa el borrador exacto y la evidencia de las pruebas; luego autoriza explícitamente la implementación
   y la asignación de números. Realiza una llamada de audio controlada en cada idioma antes de dirigir tráfico real.

Usa el [SDK de Python o TypeScript](/api-reference/sdks) para solicitudes REST tipadas.

Usa REST en lugar de MCP cuando una compilación necesite cargas útiles deterministas, elementos de prueba versionados,
orquestación masiva o una operación que no esté presente en la lista actual de herramientas MCP. La API comienza en `https://api.thunderphone.com/v1`; consulta la
[introducción a la API](/api-reference/introduction) y la
[guía de MCP](/es/guides/thunderphone-mcp-server).