Mercoa MCP by usefulapi について
Mercoa MCP by usefulapi は、MCP クライアントから Mercoa のアカウントを照会・管理するホスト型サーバーです。エンティティ、請求書、取引、支払い方法を読み取り、変更できます。
主な機能
- 01エンティティの検索と管理
- 02請求書の検索と管理
- 03取引とイベントの確認
- 04支払い方法とユーザーの表示
- 05エンティティと請求書の作成
- 06請求書指標の確認
活用シーン
- 01請求書と取引記録の確認
- 02エンティティまたは請求書の作成
- 03請求書の更新やコメント追加
MCP 対応
Mercoa のエンティティ、請求書、取引、支払い方法を操作するツールを MCP クライアントに提供します。ホスト型で、Mercoa API キーを使って認証します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mercoa.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-mercoa https://mercoa.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-mercoa":{"type":"http","url":"https://mercoa.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-mercoa":{"type":"http","url":"https://mercoa.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-mercoa":{"type":"http","url":"https://mercoa.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-mercoa":{"serverUrl":"https://mercoa.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
17| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| limit | integer | いいえ | 返すエンティティの最大数(1-100、デフォルトは 10)。 |
| search | string | いいえ | 名前、メールアドレス、emailTo、エンティティ ID、または foreign ID で検索します(一部一致)。 |
| status | any | いいえ | エンティティのステータスフィルター(例:verified、pending)。 |
| isPayee | boolean | いいえ | 受取人としてマークされたエンティティで絞り込みます。 |
| isPayor | boolean | いいえ | 支払人としてマークされたエンティティで絞り込みます。 |
| foreignId | any | いいえ | システム内におけるこのエンティティの ID(複数可)。 |
| isCustomer | boolean | いいえ | true の場合、組織と直接的な関係があるエンティティのみを対象にします。 |
| startingAfter | string | いいえ | ページネーション用のエンティティ ID カーソル。 |
| paymentMethods | boolean | いいえ | true の場合、レスポンスに支払い方法を含めます。 |
| returnMetadata | any | いいえ | レスポンスに含めるメタデータキー(複数可)。 |
詳細
usefulapi による Mercoa MCP
Claude、Cursor、または任意の MCP クライアントから Mercoa の買掛金/売掛金の請求書支払いを検索・管理できます。対象はエンティティ、請求書、取引、支払い方法です。ホスト型のため、ローカルへのインストールは不要です。Mercoa API キーを使って接続できます。
ライブエンドポイント: https://mercoa.usefulapi.io/mcp · ホームページ: https://usefulapi.io/mercoa
接続
- Claude(claude.ai、デスクトップ):Customize → Connectorsを開き、+ Add → Add custom connectorをクリックして、
https://mercoa.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http mercoa https://mercoa.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"mercoa": {
"url": "https://mercoa.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアント設定にAuthorizationヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインを行い、ログインページで Mercoa の認証情報を入力します。
手順ごとの設定方法、認証情報の確認方法、よくある質問については、https://usefulapi.io/mercoa/ をご覧ください。
初回接続時に Mercoa API キーを貼り付けます。キーは検証されたうえで、ユーザーごとに保存され、そのユーザーに限定されます。
ツール
| ツール | 種類 | 内容 |
|---|---|---|
mercoa_find_entities | 読み取り | エンティティを検索 |
mercoa_get_entity | 読み取り | エンティティを取得 |
mercoa_get_entity_events | 読み取り | エンティティのイベントを取得 |
mercoa_get_entity_invoice_metrics | 読み取り | エンティティの請求書メトリクスを取得 |
mercoa_list_entity_payment_methods | 読み取り | エンティティの支払い方法を一覧表示 |
mercoa_get_payment_method | 読み取り | 支払い方法を取得 |
mercoa_list_entity_users | 読み取り | エンティティのユーザーを一覧表示 |
mercoa_find_invoices | 読み取り | 請求書を検索 |
mercoa_get_invoice | 読み取り | 請求書を取得 |
mercoa_get_invoice_events | 読み取り | 請求書のイベントを取得 |
mercoa_find_transactions | 読み取り | 取引を検索 |
mercoa_get_transaction | 読み取り | 取引を取得 |
mercoa_get_organization | 読み取り | 組織を取得 |
mercoa_create_entity | 書き込み | エンティティを作成 |
mercoa_create_invoice | 書き込み | 請求書を作成 |
mercoa_update_invoice | 書き込み | 請求書を更新 |
mercoa_add_invoice_comment | 書き込み | 請求書にコメントを追加 |
mercoa_usage_status | メタ | 使用状況(無料プランの利用状況) |
mercoa_request_feature | メタ | 不足している機能をリクエスト |
mercoa_upgrade | メタ | Pro にアップグレード(無制限*) |
mercoa_cancel_subscription | メタ | Pro のサブスクリプションをキャンセル |
readツールは読み取り専用です。writeツールはデータを変更するため、クライアントは実行前に確認する必要があります。metaツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| Free | $0 | 月あたり50回のツール呼び出し |
| Pro | $9/月または**$90/年**(2か月分無料) | 無制限* |
*Pro には、このサーバーで月あたり10,000回のツール呼び出しという公正利用上限があります。それ以上必要な場合は、[email protected] にご連絡ください。
Pro はこのサーバーのみを対象とします。mercoa_upgradeで登録してください(Stripe Checkout のリンクが返されます)。mercoa_cancel_subscriptionでいつでもキャンセルできます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。また、その前にmercoa_upgradeを実行すると、キャンセルが取り消されます。あるいは、[email protected] にご連絡ください。
ライセンス
MIT — LICENSEを参照してください。ドキュメントのみです。サーバーはホストされています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。