マネーバード 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 スキーマ検証による完全な型安全性

セットアップ手順

基本設定

パッケージをインストールします:
npm install -g moneybird-mcp-server
Moneybird の認証情報を使用して**.env ファイルを作成します**。
MONEYBIRD_API_TOKEN=your_api_token MONEYBIRD_ADMINISTRATION_ID=your_administration_id
サーバーを実行します:
npx moneybird-mcp-server

クロードデスクトップセットアップ

Claude Desktop でこの MCP サーバーを設定するには:

まだインストールしていない場合は、パッケージをグローバルにインストールします。
npm install -g moneybird-mcp-server
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" } } } }
変更を適用するには、 Claude Desktopを再起動してください。
Claudeチャット入力に/mcp moneybirdと入力してMCPサーバーに接続します。

使用例

基本的な連絡先リスト

概要

このサーバーは、AIアシスタントがモデルコンテキストプロトコルを使用してMoneybirdの会計データとやり取りすることを可能にします。以下の機能を提供する様々なツールを提供します。

連絡先の一覧表示と取得
売上請求書を表示する
財務口座を確認する
製品とプロジェクトにアクセスする
時間エントリを表示する
カスタムMoneybird APIリクエストを作成する

前提条件

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

設定

このリポジトリをクローンします:
git clone https://github.com/vanderheijden86/moneybird-mcp-server.git cd moneybird-mcp-server
依存関係をインストールします:
npm install
例から.envファイルを作成します。
cp .env.example .env
Moneybird API 資格情報を使用して.envファイルを編集します。
- 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サーバーは、モデルコンテキストプロトコルをサポートするあらゆる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の使用
ネットワークアクセスの制限

ライセンス

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

Moneybird MCP Server

Integrations