Moneybird MCP Server

🚀 Moneybird MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を使用して、ClaudeなどのAIアシスタントをMoneybird会計ソフトウェアのAPIに接続します。

🚀 クイックスタート

このサーバーを使用すると、AIアシスタントがモデルコンテキストプロトコルを介してMoneybirdのデータとやり取りできます。主な機能は以下の通りです。

• 重要なビジネスデータの一覧表示、取得、フィルタリング
• 簡単な手順で数分以内にセットアップ可能
• ネットワーク制限や認証に関する注意事項を含むセキュリティ対策

✨ 主な機能

• 取引先管理：取引先の一覧表示、取得、フィルタリング、作成、更新が可能です。
  • 作成日、更新日、名前などの属性を使用した高度なフィルタリングが可能です。
• 財務データ：売上請求書、財務口座、支払い情報にアクセスできます。
• 業務操作：商品、プロジェクト、時間入力の管理ができます。
• カスタムリクエスト：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. .envファイルの作成：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の再起動：設定の変更を適用するために、Claude Desktopを再起動します。

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

💻 使用例

基本的な取引先一覧

サーバーを使用することで、AIアシスタントが取引先の一覧を取得できます。

🔒 セキュリティに関する注意事項

• 信頼できるネットワークのバックエンドにデプロイしてください。
• 認証機構を実装してください。
• HTTPS暗号化を使用してください。
• アクセス権限を制限してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。