Aller au contenu
local-cert
Parcourir la documentation

Serveur MCP

Les fonctionnalités de local-cert sont exposées aux agents IA par un serveur MCP sur POST /api/mcp (transport Streamable HTTP, sans état).

Authentification

La même que l'API : Authorization: Bearer <clé d'API ou JWT>, avec les mêmes scopes. Le cookie de session de la console n'y est pas accepté. Voir la référence de l'API pour les clés et les scopes.

Claude Code
claude mcp add --transport http local-cert https://certs.example.com/api/mcp \
  --header "Authorization: Bearer lc_..."
.mcp.json, ou tout client MCP acceptant un serveur HTTP
{
  "mcpServers": {
    "local-cert": {
      "type": "http",
      "url": "https://certs.example.com/api/mcp",
      "headers": { "Authorization": "Bearer ${LOCAL_CERT_API_KEY}" }
    }
  }
}

Outils

OutilÉquivalent RESTScope requis
whoami—clé valide
list_certificatesGET /api/v1/certificatesgrant sur le domaine
request_certificatePOST /api/v1/certificatescert:issue (+ dns:write si enregistrement A)
get_certificateGET /api/v1/certificates/{id}cert:read
get_certificate_eventsGET …/{id}/eventscert:read
get_certificate_bundleGET …/{id}/bundlecert:read (+ cert:export pour la clé)
renew_certificatePOST …/{id}/renewcert:renew
update_certificate_metadataPATCH /api/v1/certificates/{id}cert:issue
revoke_certificateDELETE /api/v1/certificates/{id}cert:revoke
check_subdomainGET /api/v1/subdomains/{fqdn}cert:read
list_dns_recordsGET /api/v1/dns/recordsdns:read
upsert_dns_recordPUT /api/v1/dns/recordsdns:write
delete_dns_recordDELETE /api/v1/dns/recordsdns:write
get_acme_accountGET /api/v1/acme/accountclé valide
admin_get_statsGET /api/admin/statsclé admin
admin_list_providersGET /api/admin/providersclé admin
admin_list_domains / admin_create_domain / admin_delete_domain/api/admin/domainsclé admin
admin_list_api_keys / admin_create_api_key / admin_update_api_key / admin_delete_api_key/api/admin/keysclé admin

Les outils non-admin appellent le handler REST correspondant dans le même processus, avec l'en-tête Authorization de l'appelant : authentification, scopes, validation et journal d'audit sont ceux de l'API, par construction. Une clé ne peut rien faire de plus par MCP que par curl.

Outils d'administration

Les outils admin_* ne sont listés et utilisables que pour une clé admin. C'est la seule différence avec REST, où /api/admin/* n'accepte que la session console : ici une clé admin peut gérer domaines et clés. Avant chaque appel admin, la clé est relue en base — un JWT issu d'une clé admin révoquée ou rétrogradée est donc refusé immédiatement, sans attendre son expiration.

Non exposés

/api/setup, /api/admin/session, /api/v1/auth/token, /api/healthz, /api/openapi.json (amorçage et transport, sans objet pour un agent) et le flux SSE des événements.

Skills

Le serveur embarque ses propres modes d'emploi, au format SKILL.md :

SkillCouvreVisible par
local-cert-getting-startedpermissions, erreurs, whoami, skillstous
local-cert-certificatescycle de vie d'un certificattous
local-cert-dnsdisponibilité d'un sous-domaine, enregistrementstous
local-cert-admindomaines, clés d'API, statistiquesclés admin

Deux accès équivalents : les outils list_skills / get_skill, et les ressources MCP skill://local-cert/<nom>. Le texte explique les enchaînements et les pièges ; la référence de chaque outil (rôle, scope, arguments) est générée depuis le catalogue d'outils (src/lib/mcp/tools.ts), elle ne peut donc pas diverger de ce que le serveur expose réellement.