---
title: "Desenvolva com Claude Code, Codex ou Cursor"
description: "Instale as Agent Skills do ThunderPhone, conecte o servidor MCP do ThunderPhone e forneça a um agente de programação a documentação atual do produto."
---

O ThunderPhone oferece três camadas para agentes de programação:

| Camada | O que ela oferece ao agente |
| --- | --- |
| [Habilidades de agente](https://github.com/thunderphone/skills) | Procedimentos focados para agentes, prompts, números, chamadas, ferramentas, webhooks, conhecimento, testes, campanhas, widgets, frameworks em tempo real e migrações. |
| MCP | Ferramentas autenticadas abrangem agentes, números, chamadas, testes, conhecimento, ferramentas/webhooks, campanhas, vozes, importações e documentação conforme são disponibilizadas; chame `tools/list` para ver o catálogo atual. |
| [Documentação bruta](https://thunderphone.com/docs/llms.txt) | Fontes Markdown atualizadas sobre o comportamento do produto e detalhes da API. |

As habilidades explicam como realizar o trabalho. O MCP permite que o agente de programação inspecione e atue na sua organização. A documentação bruta fornece o material de origem para perguntas fora de uma habilidade carregada.

## Instale em um projeto

Este bloco instala as habilidades, disponibiliza a chave para o shell atual
e adiciona o servidor MCP com escopo de projeto ao Claude Code. Substitua o marcador
lendo o valor real no seu gerenciador de segredos; não cole uma chave em um
repositório ou 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 o Codex, substitua o comando final por:

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

O Cursor lê uma configuração de projeto em `.cursor/mcp.json`:

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

O VS Code usa o mesmo servidor sob uma chave `servers` em `.vscode/mcp.json`:

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

<Warning>
  Uma chave de API da organização pode ler dados da organização e executar
  ações habilitadas. Mantenha-a em um gerenciador de segredos, limite o acesso ao projeto pretendido
  e revise chamadas de ferramentas que fazem alterações antes da aprovação.
</Warning>

## Exemplo de sessão: recepcionista odontológica bilíngue

1. Peça ao agente de programação para carregar `create-agent`,
   `thunderphone-prompt-builder`, `build-tool-integration`, `add-knowledge` e
   `test-agent`. Diga a ele para planejar primeiro e ainda não criar recursos.
2. Forneça fatos verificados sobre a clínica, tarefas compatíveis, regras de
   escalonamento e os dois idiomas obrigatórios. Peça que ele verifique o catálogo
   de vozes disponível e os idiomas compatíveis, em vez de inventar uma voz ou idioma.
3. Peça um único prompt de produção baseado em princípios gerais e fatos. O
   agente deve mudar para o idioma compatível de quem liga, manter a fala concisa,
   fazer uma pergunta por vez e evitar scripts de resposta de quem liga.
4. Peça que ele defina uma ferramenta de agendamento restrita e anexe apenas o
   conhecimento necessário para a recepcionista. Teste sucesso da ferramenta,
   ausência de disponibilidade, entrada inválida, tempo limite e transferência
   para uma pessoa antes da implantação.
5. Gere cenários para ambos os idiomas, interrupções, correções, informações
   ausentes, perguntas sobre conhecimento, falhas de agendamento e escalonamento.
   Execute-os, inspecione transcrições e evidências da ferramenta, corrija a menor
   regra geral e execute novamente o mesmo conjunto.
6. Revise o rascunho exato e as evidências de teste e, em seguida, autorize
   explicitamente a implantação e a associação do número. Faça uma chamada de
   áudio controlada em cada idioma antes de encaminhar tráfego real.

Use o [SDK Python ou TypeScript](/api-reference/sdks) para solicitações REST tipadas.

Use REST em vez de MCP quando uma implementação precisar de payloads determinísticos,
fixtures versionadas, orquestração em massa ou uma operação que não esteja presente
na lista atual de ferramentas MCP. A API começa em `https://api.thunderphone.com/v1`; consulte a
[introdução à API](/api-reference/introduction) e o
[guia MCP](/pt/guides/thunderphone-mcp-server).