# MCP Integration (JSON) - GoHorseJobs

Este guia centraliza como conectar o GoHorseJobs a um arquivo JSON de configuração para MCP/infra cloud/banco.

## Objetivo

Permitir bootstrap de credenciais e URL de banco sem hardcode, usando um JSON local controlado por variável de ambiente.

## Variável de ambiente

Defina:

```bash
MCP_JSON_PATH=/caminho/absoluto/para/mcp.gohorsejobs.json
```

## Estrutura esperada do JSON

Use como base:

- `config/mcp.gohorsejobs.example.json`

Campos suportados pelo backend:

- Banco:
  - `infra.database.url`
  - `database.url`
  - `database_url`
  - `databaseUrl`
- Credenciais de serviços:
  - `external_services.<service>`
  - `credentials.<service>`
  - `services.<service>`

## Serviços reconhecidos no bootstrap

- `stripe`
- `storage`
- `cloudflare_config`
- `cpanel`
- `lavinmq`
- `appwrite`
- `fcm_service_account`
- `smtp`

## Comportamento de prioridade

1. `DATABASE_URL` no ambiente continua tendo prioridade máxima.
2. Se `DATABASE_URL` não existir, o backend tenta `MCP_JSON_PATH`.
3. Para credenciais de serviços, o bootstrap usa env vars e sobrescreve com valores do JSON quando presentes.

## Segurança operacional

- Não commitar arquivo real com segredos.
- Commite apenas o template `config/mcp.gohorsejobs.example.json`.
- Mantenha `config/mcp.gohorsejobs.json` local e ignorado no git.