Moneybird MCP Server

マネーバード MCP サーバー

Claude などの AI アシスタントを API 経由で Moneybird 会計ソフトウェアに接続するモデル コンテキスト プロトコル (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 でこの 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アシスタントがモデルコンテキストプロトコルを使用して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. Moneybird API 資格情報を使用して.envファイルを編集します。
   • MONEYBIRD_API_TOKEN : Moneybird API トークン ( https://moneybird.com/user/applicationsで生成)
   • MONEYBIRD_ADMINISTRATION_ID : Moneybird管理ID（ログイン時のURLに記載）
   • MCP_SERVER_PORT : MCPサーバーを実行するポート（デフォルト: 3000）

サーバーの実行

開発の場合:

生産の場合:

AIアシスタントと併用する

このMCPサーバーは、モデルコンテキストプロトコルをサポートするあらゆるAIアシスタントと互換性があります。起動後、サーバーURLを指定することでAIアシスタントに接続できます。

利用可能なツール

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

• 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の使用
• ネットワークアクセスの制限

ライセンス

マサチューセッツ工科大学