Invompt MCP

Invompt MCP es un paquete local-beta anterior a la versión 1.0 para incorporar Claude Code y Codex a las herramientas de facturación de Invompt. Proporciona habilidades portátiles, una CLI de configuración y un puente stdio para invitados; Invompt conserva las reglas de facturación, la persistencia, el renderizado y los enlaces a documentos alojados.

Esta fuente prepara invompt-mcp@0.11.2 únicamente para el canal next. No hace ninguna afirmación de lanzamiento, producción, disponibilidad en registro o compatibilidad con hosts nuevos. Verifica el estado externo de forma independiente antes de confiar en cualquier artefacto del registro.

Hosts locales-beta compatibles

La beta local está limitada a macOS Claude Code y Codex. Sus manifiestos de paquete exponen solo habilidades; no instalan un transporte MCP estático porque el usuario debe elegir primero el modo de conexión.

El endpoint de desarrollo de bucle local es http://localhost:3101/mcp; es para desarrollo, no una configuración pública de host predeterminada. Los archivos de Gemini CLI y Qwen Code son solo plantillas y no son tiempos de ejecución locales-beta compatibles.

ChatGPT web es aparte: es remoto solo con OAuth en https://mcp.invompt.com/mcp. Nunca debe ejecutar estado/configuración local, usar un puente de invitado ni inspeccionar el estado del dispositivo local.

La CLI de este repositorio es una distribución local-beta separada. Configura únicamente invompt-local-beta; la configuración, el cierre de sesión, el restablecimiento y la reconciliación nunca eliminan ni modifican invompt. El consumidor global de Workspace Hub sigue siendo un proveedor invompt alojado, solo HTTPS y OAuth.

Related MCP server: Invoices Generator MCP Server

Configuración

Antes de una llamada a Invompt MCP, la habilidad de incorporación verifica el estado redactado. Si el modo no está decidido, pregunta exactamente si deseas Invitado u OAuth en el idioma de la conversación actual y espera tu elección explícita.

Para Codex, ejecuta un comando elegido:

npx --yes invompt-mcp@0.11.2 setup --host codex --mode guest
npx --yes invompt-mcp@0.11.2 setup --host codex --mode oauth

Para Claude Code, usa la misma CLI de paquete fijada en lugar de asumir una ruta de caché instalada:

npx --yes invompt-mcp@0.11.2 setup --host claude-code --mode guest
npx --yes invompt-mcp@0.11.2 setup --host claude-code --mode oauth

Usa status --json mediante el mismo comando del host actual para inspeccionar el estado redactado. No hay aviso posterior a la instalación ni credencial en un manifiesto o configuración de host.

El servidor MCP resultante se llama invompt-local-beta en ambos hosts. Mantén el proveedor global normal invompt separado y solo con OAuth.

El descubrimiento de complementos y habilidades usa el mismo espacio de nombres aislado: complemento invompt-local-beta, con habilidades invompt-local-beta-onboarding e invompt-local-beta-invoice. El paquete no se descubre como complemento global invompt ni como habilidad global invompt-invoice, invompt-export o invompt-health.

Invitado es primero en Keychain en macOS (com.invompt.invompt-mcp / guest-credential). Solo cuando permites explícitamente la alternativa, la configuración puede agregar --allow-file-fallback; la alternativa es texto plano con permisos restringidos en ~/.invompt/guest-credential (modo 0600). El estado local no secreto es ~/.invompt/auth-state.json (modo 0600 en un directorio 0700).

Cambiar de Invitado a OAuth deja el secreto de Invitado inactivo. Nunca se convierte automáticamente, se reclama ni se fusiona en una cuenta. Usa logout --host codex o logout --host claude-code para un cierre de sesión deliberado del host. reset --yes elimina el estado local e intenta la revocación de Invitado; si la revocación no puede alcanzar el servicio, las credenciales copiadas pueden seguir siendo válidas y la CLI informa esa advertencia.

El modo de transporte es independiente del tipo de cuenta: el Invitado OAuth alojado y el Invitado con credencial heredada son ambos principales Invitado. Una solicitud explícita de reclamo de cuenta llama a la herramienta de reclamo una vez; el backend decide la elegibilidad. Después de un reclamo de Invitado OAuth, la concesión permanece conectada y revalida el estado registrado; después de un reclamo de Invitado heredado, la credencial anterior falla con GUEST_ACCOUNT_CLAIMED.

Migración y reversión

0.11.2 agrega recuperación de enlace de actualización anulable: un update_invoice confirmado puede informar url: null con linkState: unavailable cuando la búsqueda de capacidad pierde una carrera de renovación, por lo que se renueva el enlace sin repetir la actualización. No migra un consumidor global existente solo con OAuth. Selecciona deliberadamente un modo local-beta. --allow-file-fallback es válido solo con setup --mode guest, y se rechazan banderas desconocidas o duplicadas. Para revertir el estado local-beta, primero ejecuta logout --host …; usa reset --yes solo cuando también tengas la intención de eliminar el estado de autenticación local e intentar la revocación de Invitado. Restaura el consumidor de Workspace Hub mediante su propio instalador solo con OAuth, no con esta CLI.

Fallos y privacidad

• Los fallos de red sin conexión y las respuestas 5xx son fallos temporales; no hagas bucles ni reintentes silenciosamente la emisión de credenciales.

• 401 significa que una credencial de Invitado no es válida o fue revocada; usa un restablecimiento/recuperación deliberado antes de otro intento de configuración, especialmente cuando el backend de secretos registrado no esté disponible.

• 429 respeta Retry-After; no reintentes antes de ese tiempo.

• Un error de CLI del host deja la configuración necesitando reconciliación; no afirmes que el host está configurado.

Invompt MCP no deriva ninguna huella de hardware o dispositivo y no recopila datos de serie ni direcciones MAC. La credencial de Invitado emitida por el servidor es la única identidad local seudónima; se almacena en Keychain de forma predeterminada y nunca se usa para derivar identidad de dispositivo. No tiene dependencias de tiempo de ejecución después del empaquetado, no abre ningún listener y no ejecuta lógica de negocio de facturación. Reenvía JSON-RPC solo a través del transporte seleccionado explícitamente y rechaza redirecciones HTTP.

Verificación de desarrollo

Usa Node.js 22.22.0 y npm 11.11.0 para las comprobaciones canónicas del paquete:

npm ci
npm run check

Las comprobaciones compilan, verifican tipos, ejecutan lint, prueban, escanean el código fuente y los artefactos empaquetados en busca de regresiones de secretos/privacidad, verifican la lista de permitidos exacta del paquete y prueban un consumidor aislado solo con tarball. Las comprobaciones locales no prueban un lanzamiento externo ni una instalación en un host nuevo.