マネーバード 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の使用

• ネットワークアクセスの制限

ライセンス

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