Laddro Career

Personalize currículos para vagas de emprego, gere cartas de apresentação e exporte PDFs por meio de agentes de IA.

Documentação

@laddro/career-mcp

Servidor MCP para a API Laddro Career. Dá aos agentes de IA acesso a personalização de currículos, geração de cartas de apresentação, exportação em PDF e navegação de modelos.

Configuração

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "laddro-career": {
      "command": "npx",
      "args": ["@laddro/career-mcp"],
      "env": {
        "LADDRO_API_KEY": "laddro_live_..."
      }
    }
  }
}

Claude Code

claude mcp add laddro-career -- npx @laddro/career-mcp

Defina a variável de ambiente LADDRO_API_KEY antes de executar.

HTTP Remoto

Use o endpoint Streamable HTTP hospedado:

https://mcp.laddro.com/mcp

Envie sua chave de API Laddro na solicitação de inicialização do MCP:

Authorization: Bearer laddro_live_...

ou:

x-api-key: laddro_live_...

Ferramentas disponíveis

Ferramenta	Descrição
`laddro.templates.list`	Navegue por todos os 22 modelos de currículo
`laddro.templates.get`	Obtenha cores e fontes do modelo
`laddro.fonts.list`	Todas as famílias de fontes disponíveis
`laddro.languages.list`	Todos os 14 locais suportados
`laddro.models.list`	Provedores de IA para BYOK
`laddro.resumes.list`	Currículos do usuário
`laddro.resumes.get`	Metadados do currículo
`laddro.resumes.render`	Re-renderizar com novas configurações de modelo
`laddro.resumes.tailor`	Personalizar currículo com IA para uma vaga
`laddro.resumes.export`	Exportar como PDF
`laddro.coverLetters.list`	Cartas de apresentação do usuário
`laddro.coverLetters.get`	Metadados da carta de apresentação
`laddro.coverLetters.create`	Criar manualmente
`laddro.coverLetters.generate`	Gerar com IA a partir de currículo + vaga
`laddro.coverLetters.render`	Renderizar com configurações de modelo
`laddro.settings.get`	Configuração atual do provedor de IA
`laddro.settings.updateModel`	Definir provedor BYOK
`laddro.settings.deleteModel`	Remover configuração BYOK

Modo Conector (OAuth)

Por trás da flag MCP_CONNECTOR_ENABLED (desativada por padrão). Quando ativada e uma solicitação carrega Authorization: Bearer lad_at_* (um token de acesso OAuth Laddro), o servidor executa uma sessão de conector OAuth que encaminha o token para laddro-backend (service.laddro.com) em vez de career-api. Ele também serve GET /.well-known/oauth-protected-resource (RFC 9728) e responde a chamadas /mcp não autenticadas com 401 + WWW-Authenticate: Bearer resource_metadata=... para que clientes OAuth possam descobrir o servidor de autorização. Com a flag desativada, o comportamento permanece inalterado (sem rota de descoberta, sem imposição de 401, todas as 18 ferramentas via career-api).

Ferramentas do conector (somente sessões OAuth): "Você escreve o conteúdo. A Laddro armazena e renderiza o PDF."

Ferramenta	Escopo	Descrição
`laddro.resume.schema`	—	JSON Schema para conteúdo do currículo
`laddro.resume.create`	`resumes:write`	Cria um currículo, retorna `{ resumeId }`
`laddro.resume.update`	`resumes:write`	Substitui completamente um currículo, retorna `{ resumeId, updatedAt }`
`laddro.coverLetter.schema`	—	JSON Schema para conteúdo da carta de apresentação

Variáveis de ambiente

Variável	Obrigatória	Descrição
`LADDRO_API_KEY`	Sim para stdio; fallback opcional para HTTP	Sua chave de API Laddro
`LADDRO_BASE_URL`	Não	Substituir URL da API (padrão: `https://api.laddro.com`)
`MCP_CONNECTOR_ENABLED`	Não	`true` ativa o modo conector OAuth (desativado por padrão)
`LADDRO_BACKEND_URL`	Não	URL base do backend para ferramentas do conector (padrão: `https://service.laddro.com`)
`MCP_PUBLIC_URL`	Não	URL pública deste servidor para metadados OAuth (caso contrário, derivada dos cabeçalhos encaminhados)

Desenvolvimento

npm ci
npm test

npm test compila o pacote TypeScript e executa testes de contrato MCP para tratamento de autenticação, metadados de ferramentas e roteamento de manipuladores.

Lançamentos

Este pacote usa Changesets e SemVer.

Patch: correções de bugs, documentação, testes, endurecimento interno.
Minor: novas ferramentas ou capacidades MCP compatíveis com versões anteriores.
Major: mudanças que quebram nomes de ferramentas, esquemas, autenticação ou comportamento de transporte.

Todo PR que altera o pacote publicado deve incluir um changeset:

npm run changeset

Após o PR ser mesclado em main, o GitHub Actions abre um PR de lançamento com o aumento de versão e o changelog. Mesclar esse PR de lançamento publica o pacote no npm e cria o lançamento no GitHub. O fluxo de trabalho de implantação do Cloud Run também é executado em main, então o MCP hospedado é atualizado automaticamente após as mesclagens de lançamento.

Registro MCP

Este servidor está listado no registro MCP oficial como com.laddro/career. server.json é o manifesto do registro; scripts/sync-version-metadata.mjs mantém sua versão em sincronia com o pacote npm em cada lançamento.

A publicação é automatizada: .github/workflows/publish-registry.yml é executado sempre que um lançamento altera server.json em main e envia a nova versão para o registro. A autenticação é baseada em DNS — a chave pública Ed25519 está no registro TXT laddro.com, e a chave privada correspondente (hex) é armazenada como o segredo do repositório MCP_PUBLISHER_ED25519_KEY.

Para publicar (ou atualizar) manualmente:

MCP_PUBLISHER_ED25519_KEY=<hex-private-key> ./scripts/publish-registry.sh

Licença

MIT