e1c61289af
Enable backend fallback to MCP JSON for database connection when DATABASE_URL is absent.\nAdd credentials bootstrap support from JSON for cloud/external services.\n\nConsolidate documentation with MCP integration guide and unified status.\nUpdate backlog to move video interviews endpoint out of current sprint. Co-Authored-By: Claude <noreply@anthropic.com>
56 lines
1.3 KiB
Markdown
56 lines
1.3 KiB
Markdown
# 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.
|