World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 97 tools.
Se ejecuta en la nube✓ del servicio · worldmonitor.app
Gooodbilling MCP
What it does
GooodBilling 公式 MCP Server — Claude Desktop / Cursor 等の MCP 対応クライアントから AI ファーストで請求書・見積を操作する
- Connects Se ejecuta en tu computadora
- Account or key Needs GOOODBILLING_API_TOKEN
- Category Otros
Instalación
Elige la app de IA que usas y copia la configuración.
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Gooodbilling MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Que la IA lo instale
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Gooodbilling MCP para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "gooodbilling": { "command": "npx", "args": [ "-y", "@gooodbilling/mcp-server" ], "env": { "GOOODBILLING_API_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOODBILLING_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Gooodbilling MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Regístrate y crea una clave de Gooodbilling MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Pega esta configuración y guarda el archivo
{ "mcpServers": { "gooodbilling": { "command": "npx", "args": [ "-y", "@gooodbilling/mcp-server" ], "env": { "GOOODBILLING_API_TOKEN": "your-value" } } } }Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Cierra Claude y vuelve a abrirlo
Pruébalo
Usa Gooodbilling MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Gooodbilling MCP o muestra una herramienta de Gooodbilling MCP en la respuesta, ya está conectado
1 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GOOODBILLING_API_BASE_URLAPI ベースURL。任意。既定は https://gooodbilling.com
Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Gooodbilling MCP
Gooodbilling MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
Lo que puedes hacer en su lugar
A · Usa una app que pueda conectar Gooodbilling MCP
- Necesitas una clave de Gooodbilling MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
- Necesitas una clave de Gooodbilling MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
- Necesitas una clave de Gooodbilling MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
- Necesitas una clave de Gooodbilling MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
B · Otros en Otros que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
- Hostinger✓ ChatGPT
- World Monitor✓ ChatGPT
- Svelte MCP✓ ChatGPT
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Gooodbilling MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Gooodbilling MCP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user gooodbilling --env GOOODBILLING_API_TOKEN=your-value -- npx -y @gooodbilling/mcp-server 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOODBILLING_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Gooodbilling MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Regístrate y crea una clave de Gooodbilling MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Pega este comando y pulsa Enter
claude mcp add --scope user gooodbilling --env GOOODBILLING_API_TOKEN=your-value -- npx -y @gooodbilling/mcp-serverCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Escribe /mcp en Claude Code
Deberías ver Gooodbilling MCP en la lista como conectado
Pruébalo
Usa Gooodbilling MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Gooodbilling MCP o muestra una herramienta de Gooodbilling MCP en la respuesta, ya está conectado
1 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GOOODBILLING_API_BASE_URLAPI ベースURL。任意。既定は https://gooodbilling.com
Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Gooodbilling MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Gooodbilling MCP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "gooodbilling": { "command": "npx", "args": [ "-y", "@gooodbilling/mcp-server" ], "env": { "GOOODBILLING_API_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOODBILLING_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Gooodbilling MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Regístrate y crea una clave de Gooodbilling MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Escribe tu clave
En la configuración de Gooodbilling MCP, GOOODBILLING_API_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Abre el chat de IA de Cursor en modo Agent
Pruébalo
Usa Gooodbilling MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Gooodbilling MCP o muestra una herramienta de Gooodbilling MCP en la respuesta, ya está conectado
1 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GOOODBILLING_API_BASE_URLAPI ベースURL。任意。既定は https://gooodbilling.com
Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Gooodbilling MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Gooodbilling MCP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "gooodbilling": { "type": "stdio", "command": "npx", "args": [ "-y", "@gooodbilling/mcp-server" ], "env": { "GOOODBILLING_API_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOODBILLING_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Gooodbilling MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Regístrate y crea una clave de Gooodbilling MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Escribe tu clave
En la configuración de Gooodbilling MCP, GOOODBILLING_API_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Abre el chat de IA de VS Code en modo Agent
Pruébalo
Usa Gooodbilling MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Gooodbilling MCP o muestra una herramienta de Gooodbilling MCP en la respuesta, ya está conectado
1 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GOOODBILLING_API_BASE_URLAPI ベースURL。任意。既定は https://gooodbilling.com
Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Para desarrolladores: comandos de Terminal y configuración JSON
Instalado en tu computadora
Claude Code
claude mcp add --scope user gooodbilling --env GOOODBILLING_API_TOKEN=your-value -- npx -y @gooodbilling/mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"gooodbilling": {
"command": "npx",
"args": [
"-y",
"@gooodbilling/mcp-server"
],
"env": {
"GOOODBILLING_API_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"gooodbilling": {
"command": "npx",
"args": [
"-y",
"@gooodbilling/mcp-server"
],
"env": {
"GOOODBILLING_API_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"gooodbilling": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gooodbilling/mcp-server"
],
"env": {
"GOOODBILLING_API_TOKEN": "your-value"
}
}
}
}Valores que debes completar
GOOODBILLING_API_TOKENsecreto obligatorio envGooodBilling API トークン (gb_live_...)。https://gooodbilling.com/settings/api-tokens で発行GOOODBILLING_API_BASE_URLenvAPI ベースURL。任意。既定は https://gooodbilling.com
Las descripciones siguen en el inglés original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
De un vistazo
Qué apps pueden usarlo
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Qué puede hacer
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisiones básicasi
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 15 nov 2026
- ✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub gooodbilling, dueña del repo
- ✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 5 meses
- ✓ Superada
Tiene licencia
Usa MIT
- – No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
- – No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
- … Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Vulnerabilidades publicadas (OSV.dev)
Aún no revisado
Creadores: pedir otra revisión o avisar de un dato erróneo
Conversación
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Reseñas de usuarios
Aún no hay reseñas
Comparado con otros en Otrosi
- Más estrellas que el 0% de los otros 19865 servidores de esta categoría
- Publicado en el registro más recientemente que el 8% de los otros 19865 servidores de esta categoría
- Revisiones básicas iguales o mejores que el 100% de los otros 19865 servidores de esta categoría
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Preguntas frecuentes
¿Es seguro Gooodbilling MCP?
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
¿Qué claves o códigos necesita?
Debes completar: GOOODBILLING_API_TOKEN
¿Se ejecuta en mi computadora o en la nube?
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
¿Sigue en mantenimiento?
El repo de GitHub cambió por última vez hace 5 meses, y la última versión (0.1.14) llegó al registro hace 5 meses.
¿Qué apps pueden usarlo?
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
¿Qué puedo usar en su lugar?
En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Alternativas parecidas
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
openstatus
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Se ejecuta en la nube✓ del servicio · openstatus.dev
Oh My Posh Validator
Validate oh-my-posh configurations and segment snippets against the official schema.
Se ejecuta en la nube✓ del servicio · ohmyposh.dev
Strata
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Se ejecuta en la nubeRepo archivado✓ klavis.ai
Jitsu
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
Se ejecuta en la nube✓ del servicio · jitsu.com
- World Monitor — Funciona en la nube, sin instalar nada · Sin clave
- openstatus — Funciona en la nube, sin instalar nada · Sin clave
- Oh My Posh Validator — Funciona en la nube, sin instalar nada · Sin clave
- Strata — Funciona en la nube, sin instalar nada · Sin clave
- Jitsu — Funciona en la nube, sin instalar nada · Sin clave
README del creador
Abrir el README
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
@gooodbilling/mcp-server
GooodBilling 公式 MCP Server。Claude Desktop / Cursor 等の MCP 対応クライアントから、AI ファーストで請求書・見積書を操作できます。
「A 社向け Web 制作 30 万円で請求書作って」「保守費 10 万円も追加して」「これで送信して」— PC を開かず、チャットだけで業務を完結できます。
動作要件
- Node.js 18 以上
- GooodBilling アカウントと API トークン (発行手順は下記)
API トークンの発行
- GooodBilling にログイン
設定 > AI 連携 > API トークンを開く- 「新しいトークンを発行」をクリック
- 用途別テンプレートから選択 (Claude Desktop 推奨スコープを選ぶと簡単)
- 表示された平文トークン (
gb_live_...) を 1 度だけコピー
⚠️ トークンは発行時に 1 度だけしか表示されません。必ずすぐに MCP クライアントの設定に登録してください。
Claude Desktop での設定
1. 設定ファイルを開く
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
2. mcpServers セクションに以下を追加
{"mcpServers": { "gooodbilling": { "command": "npx", "args": ["-y", "@gooodbilling/mcp-server"], "env": { "GOOODBILLING_API_TOKEN": "gb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } } } }
3. Claude Desktop を再起動
ツールアイコンに gooodbilling が表示されれば成功です。
💡 AI への話しかけ方 (重要)
Claude / ChatGPT 等の AI は、あなたのチャットを 複数の MCP (Gmail / Calendar / Drive / Stripe など) や Web 検索 から拾える状態で受け取ります。「カナリア出版の連絡先教えて」とだけ言われると、AI は GooodBilling の取引先なのか実在出版社なのか判断できず、確認質問されるか Web 検索に流れます。
これを避けるため、セッション最初の 1 発目 だけ以下のヒント語を含めてください。2 発目以降は文脈が確立されるので省略 OK です。
単語の 3 段階
| 段階 | 例 | プレフィックス必要? |
|---|---|---|
| Tier 1: GooodBilling 固有語 | 請求書 / 未払い / 未入金 / 売掛 / 見積 / 案件 / インボイス | ❌ 不要 (単独で OK) |
| Tier 2: 他システムにもある語 | 連絡先 / 売上 / 送信 / 設定 / 取引履歴 | ✅ 必要 |
| Tier 3: 固有名詞のみ | 会社名だけ (カナリア出版 等) | ✅ 必要 |
プレフィックス語の選択肢
どれか 1 つ含めれば OK:
GooodBillingで/GooodBillingの請求システムの/請求管理の取引先の/顧客の/売上先のAI 連携の(送信機能・設定の文脈)
良い例 / 悪い例
| ❌ 曖昧 (Web 検索に流れる / 確認質問される) | ✅ 確実に呼ぶ |
|---|---|
カナリア出版の連絡先教えて | 取引先のカナリア出版の連絡先教えて |
今月の売上どんなもん？ | 請求システムの今月の売上は？ |
送信機能 ON だっけ？ | AI 連携の送信機能 ON だっけ？ |
あの会社の電話番号 | 顧客の○○社の電話番号 |
請求書 未払い 未回収 売掛金 見積 案件 のような Tier 1 語を含む場合はそのまま使えます:
- ✅
カナリア出版に 5 万円で請求書出して←請求書で確定 - ✅
未払いある？←未払いで確定 - ✅
未回収教えて←未回収で確定 - ✅
カナリアの見積一覧見せて←見積で確定
🔀 Stripe / 決済プロバイダ系 MCP を併用している場合
AI クライアントに Stripe など他の請求・決済 MCP が同時接続されていると、Tier 1 単語であっても AI 側がそちらを優先することがあります (「未払い」「請求書」等は Stripe のドメインにも存在するため)。
その環境では 最初の 1 発目に `GooodBillingで` を付けるのが最も確実:
| フレーズ | 起こりうる挙動 (Stripe 併用時) |
|---|---|
未払いある？ | Stripe を優先選択する可能性 |
売上どう？ | Stripe Payments の売上を見に行く |
請求書一覧 | Stripe Invoices を優先することがある |
対策の優先順:
- ブランド名プレフィックス (最確実):
GooodBillingで未払いある？ - GooodBilling 固有用語:
売掛金の未回収どう？/請求書 (発行側) の未払い見せて - 文脈確立: 最初の 1 発に
適格請求書の発行状況等の業務特化語を使う → 2 発目以降は省略可
📱 AI クライアント別の挙動メモ
| クライアント | プレフィックス | 備考 |
|---|---|---|
| Claude Desktop / Cursor | (上記ルール) | ツール権限「常に許可」推奨 |
| ChatGPT (Custom GPTs Actions) | 不要 | OpenAPI で 1 API のみ呼ぶため曖昧性なし |
| LINE / Slack Bot | 不要 | Bot 実装が GooodBilling API のみ叩く設計 |
| Zapier / Make / n8n | 不要 | トリガー/アクションで API 明示。スコープ最小化推奨 |
提供ツール (16 個)
取引先
- `search_customers` — 取引先を検索 (名前・カナ・メール・登録番号)
請求書
- `list_invoices` — 請求書一覧 (status / customer / 期間フィルタ)
- `list_unpaid_invoices` — 未入金請求書一覧 (overdue 限定可)
- `get_invoice` — 請求書 1 件詳細
- `create_invoice_draft` — 請求書ドラフト作成 (必ず
draft状態) - `update_invoice_draft` — ドラフト部分更新 (items 配列全置換)
- `discard_invoice_draft` — ドラフト破棄 (draft 状態のみ)
- `send_invoice` — 取引先へメール送付 (idempotency-key 自動付与)
見積
- `list_quotes` — 見積一覧
- `get_quote` — 見積 1 件詳細
- `create_quote_draft` — 見積ドラフト作成
- `update_quote_draft` — ドラフト部分更新
- `discard_quote_draft` — ドラフト破棄
- `send_quote` — 取引先へメール送付
レポート
- `get_sales_summary` — 期間集計 (請求金額・入金額・未入金額)
テナント設定
- `get_tenant_settings` — 送信機能 ON/OFF、BCC 自動付与、既定税率の確認 (read-only)
「作成 → 確認 → 送信」二段階フロー (サンプル会話)
👤 ユーザー「A社向けに、Web制作費 30万円で請求書ドラフトを作って」
🤖 Claude search_customers({query: "A社"}) → cus_xxx (株式会社サンプルA) create_invoice_draft({customer_id: "cus_xxx", title: "Web 制作費", ...}) → { id: "inv_yyy", status: "draft", total_amount: 330000, pdf_preview_url: "..." }
「下書きを作成しました。 取引先: 株式会社サンプルA 合計: ¥330,000 (税込) PDF を確認する 内容に問題なければ『送信して』とお伝えください。」
👤 ユーザー 「保守費 10万円も追加して」
🤖 Claude get_invoice({invoice_id: "inv_yyy"}) → 現状取得 update_invoice_draft({invoice_id: "inv_yyy", items: [Web制作費, 保守費]}) → total_amount: 440000
「修正しました。保守費 10万円を追加し、合計 ¥440,000 になりました。 更新後の PDF を確認」
👤 ユーザー 「OK、送信して」
🤖 Claude send_invoice({invoice_id: "inv_yyy"}) → status: "sent"
「A社の担当者様 (billing@example.com) へ送付完了しました。 控えがあなたのメールにも届きます。」
AI エージェント実装者向けベストプラクティス
このセクションは MCP Server を組み込むアプリケーション (LINE Bot, Slack Bot, 音声アシスタント等) の実装者向けです。AI モデルがツール呼出を組み立てる際に守ってほしい原則です。
1. 取引先の確定: 架空 ID を捏造しない
create_invoice_draft / create_quote_draft に渡す customer_id は、必ず `search_customers` で取得した実在 ID を使ってください。AI が記憶や推測で UUID を組み立てると 422 invalid_request が返ります。
検索結果が 0 件の場合は、新規取引先を勝手に登録せず、ユーザーに正式名称の確認を促してください。
2. 税率: 指定しないことを推奨
items[].tax_rate_code は 省略を推奨します。サーバー側が以下の優先順位で自動補完します:
- 商品マスタの既定税率 (description が一致する場合)
- 取引先マスタの既定税率
- テナント既定税率
- 標準 10% (STD10)
AI が幻覚で軽減税率を勝手に当てる事故を構造的に避けられます。指定する場合はテナントの税率マスタに登録されたコード (例: STD10, RED8) を渡してください。
3. 修正前の現状把握
update_invoice_draft / update_quote_draft を呼ぶ前に、必ず `get_invoice` / `get_quote` で最新状態を取得し、items[] をメモリ上で merge してから PATCH してください。
items[] を含む PATCH は配列全置換のため、merge を怠ると既存明細が失われます。
4. 送信前の必須レビュー
send_invoice / send_quote は 取引先へメール送付を実行し、取り消し不可です。
呼出前に必ず pdf_preview_url をユーザーに提示し、明示同意 (「送信して」「OK」等) を取得してください。AI が単独判断で送信することは避けてください。
5. 冪等性キーの扱い
送信系ツールは idempotency_key を省略可能です。MCP Server が UUID を自動生成して付与します。
同一送信意図 (例: ユーザーが「送信」と 2 回連続で入力した場合) では、同じ idempotency_key を渡すと二重送信が構造的に防止されます。
6. 破棄のスコープ
discard_invoice_draft / discard_quote_draft は draft 状態の書類のみを破棄できます。
確定済 (issued / sent / paid) 書類の取消は API では行わず、ユーザーに「Web 画面での赤伝処理が必要」と案内してください。
環境変数
| 変数 | 必須 | 既定値 | 説明 |
|---|---|---|---|
GOOODBILLING_API_TOKEN | ✅ | — | API トークン (gb_live_...) |
GOOODBILLING_API_BASE_URL | ❌ | https://gooodbilling.com | API ベース URL (セルフホスト / staging 用) |
トラブルシューティング
FATAL: GOOODBILLING_API_TOKEN is not set で起動失敗
→ MCP クライアント設定の env セクションにトークンが正しく設定されているか確認してください。
401 invalid_token が返る
→ トークンが失効済 / 期限切れの可能性。管理画面で再発行してください。
403 insufficient_scope が返る
→ トークンに必要なスコープが付与されていません (例: send_invoice には emails:send + invoices:write が必要)。管理画面でスコープを確認し、不足があれば再発行してください。
403 send_disabled_by_tenant が返る
→ テナント管理者が「AI / API 経由送信」を一時停止しています。管理画面 設定 > AI 連携 > API トークン > 送信設定 で有効化してください。
422 customer_email_missing が返る
→ 取引先の担当者にメールアドレスが登録されていません。Web 画面で取引先担当者のメールを設定するか、send_invoice の to パラメータで明示指定してください。
ライセンス
MIT