gohorsejobs/docs/MCP_INTEGRATION.md
root e1c61289af feat(config): Add MCP JSON bootstrap and unify docs
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>
2026-03-09 20:39:16 +01:00

1.3 KiB

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:

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.