Invoice by Ouroboros Apps

Invoice

Invoice では、フリーランサーが承認した請求書（項目、数量、承認済みの単価、支払期日、遅延時の条件）を保持し、アシスタントが回答する前にその記録を読み取れるようにします。変更が明示的に承認されていない限り、アシスタントは項目の追加、単価の変更、割引の創作、支払期日の変更を行えません。

ChatGPT、Claude、Gemini、Grok、Cursor、および Streamable HTTP と OAuth に対応するその他の MCP クライアントで利用できます。ChatGPT 専用のプラグインではありません。

アシスタントが OAuth を開いたら、Invoice アカウントでサインインしてください。API キーやパスワードをヘッダーに貼り付けないでください。Invoice は動的クライアント登録に対応しています。クライアント ID とシークレットは空欄のままにしてください。/.well-known/oauth-protected-resource/mcp の保護リソースメタデータが、クライアントを OAuth 発行者に誘導し、そこでクライアントが登録されます。

Invoice のツールを利用するには、Pro または有効なトライアルが必要です。新しいサブスクリプションには14日間のトライアルが含まれます。このページには価格を掲載していません。チェックアウト画面に請求間隔と支払い条件が表示されます。請求書に保存される金額は、その通貨の最小単位で表した、フリーランサーが承認済みの金額です。製品価格ではありません。

セルフホストするには、サーバーを起動し、設定したベース URL を使用してください。デフォルトの MCP アドレスは http://127.0.0.1:3000/mcp です。

ホスト型サーバー

• MCP サーバー URL：https://invoice-continuity2.vercel.app/mcp（Streamable HTTP、OAuth サインイン）
• ドキュメント：https://ouroborosapps.com/docs/invoice
• ステータス：早期アクセス。URL を Claude、Cursor、Grok、または ChatGPT の開発者モードに貼り付けてください。
• レジストリ名：io.github.LAHutchins91/invoice

アシスタントができること

接続を承認すると、サーバーは次のツールを公開します。

• list_invoices
• begin_invoice
• read_invoice
• place_line
• describe_line
• quote_line_rate
• set_line_quantity
• set_invoice_due
• write_late_terms
• offer_discount
• seal_invoice
• suggest_invoice_change
• accept_invoice_change

read_invoice は、アシスタントが回答する前に実行すべき読み取り操作です。下書きの金額は承認済みの約束ではありません。請求書の変更提案を行っても、記録は変更されません。請求書が確定された後は、place_line は新しい項目を拒否し、quote_line_rate は単価の変更を拒否し、offer_discount は割引を拒否し、set_invoice_due は支払期日の変更を拒否します。こうした変更は suggest_invoice_change を経由してから accept_invoice_change で確定し、変更を明示的に承認した場合にのみ適用されます。

アシスタントがこれらのツールを呼び出すのは、あなたとホストが許可した場合のみです。

接続

Cursor の場合は、~/.cursor/mcp.json またはプロジェクトの .cursor/mcp.json に設定します。

{
  "mcpServers": {
    "invoice": {
      "url": "http://127.0.0.1:3000/mcp"
    }
  }
}

ヘッダーのブロックを追加しないでください。Cursor がクライアントを登録し、サインイン画面を開きます。

Claude Code：

claude mcp add --transport http invoice http://127.0.0.1:3000/mcp

Authorization ヘッダーを渡さないでください。その他のクライアントでも同じアドレスを使用し、OAuth を選択して、クライアント ID とシークレットを空欄のままにします。ChatGPT、Claude、Gemini、Grok、Cursor の手順は、/connect の接続ページにあります。

このサーバーのレジストリメタデータは server.json（io.github.LAHutchins91/invoice）にあります。そこに記載されているリモート URL は https://invoice-continuity2.vercel.app/mcp です。

実行

npm install
npm test
npm run typecheck
npm run build
npm start

標準入力がターミナルの場合、Invoice はポート 3000 で Streamable HTTP を提供します。標準入力がターミナルではない場合、stdio 経由で MCP を通信し、HTTP ポートも引き続き開きます。stdio モード中のログは、プロトコルと混ざらないよう stderr に出力されます。

レコードは JSON ファイルに永続的に保存されます。デフォルトのパスは ~/.invoice/invoice.json です。保存先を変更するには INVOICE_DATA_PATH を設定してください。このファイルを所有するサーバープロセスは 1 つだけにしてください。他の製品のデータファイルを指定しないでください。

OAuth は、動的クライアント登録を備えた Supabase 認可サーバーと同じ方式を使用します。これらは MCP ヘッダーではなく、サーバープロセスに設定してください。

• APP_BASE_URL（デフォルトは http://localhost:3000）
• SUPABASE_URL
• SUPABASE_ANON_KEY
• STRIPE_SECRET_KEY
• STRIPE_WEBHOOK_SECRET
• STRIPE_PRICE_MONTHLY と STRIPE_PRICE_YEARLY（Stripe カタログ ID。価格ではありません）
• OPENAI_APPS_CHALLENGE（省略可能。設定すると、/.well-known/openai-apps-challenge はそのトークンをプレーンテキストで返します）

検出以外のツール呼び出しには、サブスクリプションのステータスが active または trialing のサインイン済みアカウントが必要です。

---

Ouroboros のその他の情報：https://ouroborosapps.com