mcpField
M
Mercoa MCP by usefulapi

Mercoa MCP by usefulapi

リモート
usefulapi.io金融データ0今日更新
リポジトリ公式サイト

Mercoa MCP by usefulapi について

Mercoa MCP by usefulapi は、MCP クライアントから Mercoa のアカウントを照会・管理するホスト型サーバーです。エンティティ、請求書、取引、支払い方法を読み取り、変更できます。

主な機能

  1. 01エンティティの検索と管理
  2. 02請求書の検索と管理
  3. 03取引とイベントの確認
  4. 04支払い方法とユーザーの表示
  5. 05エンティティと請求書の作成
  6. 06請求書指標の確認

活用シーン

  1. 01請求書と取引記録の確認
  2. 02エンティティまたは請求書の作成
  3. 03請求書の更新やコメント追加

MCP 対応

Mercoa のエンティティ、請求書、取引、支払い方法を操作するツールを MCP クライアントに提供します。ホスト型で、Mercoa API キーを使って認証します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mercoa.usefulapi.io/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

17
パラメーター型必須説明
limitintegerいいえ返すエンティティの最大数(1-100、デフォルトは 10)。
searchstringいいえ名前、メールアドレス、emailTo、エンティティ ID、または foreign ID で検索します(一部一致)。
statusanyいいえエンティティのステータスフィルター(例:verified、pending)。
isPayeebooleanいいえ受取人としてマークされたエンティティで絞り込みます。
isPayorbooleanいいえ支払人としてマークされたエンティティで絞り込みます。
foreignIdanyいいえシステム内におけるこのエンティティの ID(複数可)。
isCustomerbooleanいいえtrue の場合、組織と直接的な関係があるエンティティのみを対象にします。
startingAfterstringいいえページネーション用のエンティティ ID カーソル。
paymentMethodsbooleanいいえtrue の場合、レスポンスに支払い方法を含めます。
returnMetadataanyいいえレスポンスに含めるメタデータキー(複数可)。

詳細

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を参照してください。ドキュメントのみです。サーバーはホストされています。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。