Moneybird MCP Server

Moneybird MCP Server

Claude などの AI アシスタントを API 経由で Moneybird の会計ソフトウェアに接続する、Model Context Protocol（MCP）サーバーです。

機能

• 連絡先管理：連絡先の一覧表示、取得、フィルタリング、作成、更新
  • 作成日、更新日、名前などによる高度なフィルタリング
• 財務データ：売上請求書、金融口座、支払いへのアクセス
• 業務オペレーション：商品、プロジェクト、作業時間記録の管理
• カスタムリクエスト：Moneybird のエンドポイントへのカスタム API リクエスト
• 対話型アシスタント：Moneybird アシスタント用の事前設定済みプロンプト

新しい開発内容

• 連絡先フィルタリングの強化：Moneybird の高度なクエリ構文を使った連絡先のフィルタリング
  • 作成日でフィルタリング：created_after:2023-01-01 00:00:00 UTC
  • 更新日でフィルタリング：updated_after:2023-01-01 10:45:35 UTC
  • プロパティでフィルタリング：first_name:value など
• エラーハンドリングの改善：よりわかりやすいエラーメッセージと復旧機能
• パフォーマンスの最適化：大規模なデータセット向けのレスポンス分割
• TypeScript との統合：Zod スキーマ検証による完全な型安全性

セットアップ手順

基本セットアップ

1. パッケージをインストールします：

   npm install -g moneybird-mcp-server
   

2. Moneybird の認証情報を含む .env ファイルを作成します：

   MONEYBIRD_API_TOKEN=your_api_token
   MONEYBIRD_ADMINISTRATION_ID=your_administration_id
   

3. サーバーを起動します：

   npx moneybird-mcp-server
   

Claude Desktop のセットアップ

Claude Desktop でこの MCP サーバーをセットアップする手順は次のとおりです。

1. まだインストールしていない場合は、パッケージをグローバルにインストールします：

   npm install -g moneybird-mcp-server
   

2. Claude Desktop の設定ファイル（通常は ~/Library/Application Support/Claude/claude_desktop_config.json）を作成または編集し、MCP サーバーの設定を追加します：

   {
     "mcpServers": {
       "moneybird": {
         "command": "npx",
         "args": [
           "-y",
           "moneybird-mcp-server"
         ],
         "env": {
           "MONEYBIRD_API_TOKEN": "your_api_token_here",
           "MONEYBIRD_ADMINISTRATION_ID": "your_administration_id_here"
         }
       }
     }
   }
   

3. 変更を適用するために Claude Desktop を再起動します

4. Claude のチャット入力欄で /mcp moneybird と入力し、MCP サーバーに接続します

使用例

基本的な連絡先一覧の表示

概要

このサーバーを使用すると、AI アシスタントが Model Context Protocol を使って Moneybird の会計データを操作できます。次のような各種ツールを提供します。

• 連絡先の一覧表示と取得
• 売上請求書の表示
• 金融口座の確認
• 商品とプロジェクトへのアクセス
• 作業時間記録の表示
• Moneybird API へのカスタムリクエスト

前提条件

• Node.js（v18 以上を推奨）
• API アクセスが可能な Moneybird アカウント
• Moneybird API トークン

セットアップ

1. このリポジトリをクローンします：

   git clone https://github.com/vanderheijden86/moneybird-mcp-server.git
   cd moneybird-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. サンプルから .env ファイルを作成します：

   cp .env.example .env
   

4. .env ファイルを Moneybird API の認証情報で編集します：

   • MONEYBIRD_API_TOKEN：Moneybird API トークン（https://moneybird.com/user/applications で生成します）
   • MONEYBIRD_ADMINISTRATION_ID：Moneybird の管理 ID（ログイン後の URL で確認できます）
   • MCP_SERVER_PORT：MCP サーバーを実行するポート（デフォルト：3000）

サーバーの実行

開発環境の場合：

npm run dev

本番環境の場合：

npm run build
npm start

AI アシスタントでの使用

この MCP サーバーは、Model Context Protocol をサポートするあらゆる AI アシスタントと互換性があります。起動したら、サーバー URL を指定して AI アシスタントに接続できます。

http://your-server-address:3000

利用可能なツール

サーバーは次のツールを提供します。

• list_contacts：Moneybird のすべての連絡先を一覧表示
• get_contact：ID を指定して特定の連絡先の詳細を取得
• list_sales_invoices：すべての売上請求書を一覧表示
• get_sales_invoice：ID を指定して特定の売上請求書の詳細を取得
• list_financial_accounts：すべての金融口座を一覧表示
• list_products：すべての商品を一覧表示
• list_projects：すべてのプロジェクトを一覧表示
• list_time_entries：すべての作業時間記録を一覧表示
• moneybird_request：Moneybird API にカスタムリクエストを送信

セキュリティ

このサーバーは Moneybird データへのアクセスを提供するため、適切なセキュリティ対策を講じてデプロイしてください。 次の点を検討してください。

• セキュアなプロキシの背後で実行する
• MCP サーバーの認証を実装する
• HTTPS を使用する
• ネットワークアクセスを制限する

ライセンス

MIT