Vyfakturuj MCP by usefulapi について
Vyfakturuj MCPは、ClaudeやCursorなどのMCPクライアントからVyfakturujを利用するホスト型サービスです。請求書と連絡先の検索・作成に加え、番号系列や支払方法、タグを確認できます。
主な機能
- 01請求書の検索と取得
- 02正式な番号付き請求書の作成
- 03連絡先の検索と作成
- 04定期請求書テンプレートの表示
- 05番号系列、支払方法、タグの確認
活用シーン
- 01既存の請求書の検索や確認
- 02Vyfakturujでの請求書作成
- 03顧客連絡先の検索や追加
- 04番号系列と支払方法の確認
MCP 対応
ホスト型MCPサーバーとして、Vyfakturujの請求書、連絡先、番号系列、支払方法、タグを扱うツールを提供します。ログインページで認証情報を入力し、OAuthで接続します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://vyfakturuj.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-vyfakturuj https://vyfakturuj.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-vyfakturuj":{"type":"http","url":"https://vyfakturuj.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-vyfakturuj":{"type":"http","url":"https://vyfakturuj.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-vyfakturuj":{"type":"http","url":"https://vyfakturuj.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-vyfakturuj":{"serverUrl":"https://vyfakturuj.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
10| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| q | string | いいえ | 請求書を全文検索します。 |
| VS | string | いいえ | Variable symbol (variabilni symbol). |
| sort | string | いいえ | 並べ替え:column~asc または column~desc。複数指定する場合は | で連結します(例:date_created~desc|number~asc)。 |
| type | any | いいえ | Document type: 1 faktura, 2 zalohova faktura, 4 proforma, 8 vyzva k platbe, 16 danovy doklad, 32 opravny danovy doklad, 64 prijmovy doklad, 128 opravny doklad, 512 objednavka. |
| number | string | いいえ | 書類番号の完全一致。 |
| currency | string | いいえ | 通貨、ISO 4217。例:CZK、EUR。 |
| rows_limit | integer | いいえ | 返す行数。1~100(デフォルトは 25)。 |
| id_customer | any | いいえ | このアドレス帳の連絡先の請求書のみ(vyfakturuj_list_contacts から取得)。 |
| rows_offset | integer | いいえ | スキップする行数(デフォルトは 0)。前回の応答の next_offset を使用します。 |
| date_created_to | string | いいえ | この日付(yyyy-mm-dd)以前に作成された取引。 |
| date_created_from | string | いいえ | この日付(yyyy-mm-dd)以降に作成された取引。 |
詳細
Vyfakturuj MCP by usefulapi
Claude、Cursor、または任意の MCP クライアントから Vyfakturuj を使用できます。請求書や連絡先の検索、請求書や連絡先の作成、番号体系、支払い方法、タグの確認ができます。 ホスト型のため、ローカルへのインストールは不要です。ご自身の Vyfakturuj の認証情報で接続できます。
ライブエンドポイント: https://vyfakturuj.usefulapi.io/mcp · ホームページ: https://usefulapi.io/vyfakturuj
接続
- Claude(claude.ai、デスクトップ):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://vyfakturuj.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http vyfakturuj https://vyfakturuj.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"vyfakturuj": {
"url": "https://vyfakturuj.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアントの設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でログインし、ログインページで Vyfakturuj の認証情報を求められます。
設定手順、認証情報の確認方法、よくある質問:https://usefulapi.io/vyfakturuj/
ツール
| ツール | 種類 | 機能 |
|---|---|---|
vyfakturuj_list_invoices | 読み取り | 請求書の一覧を取得 |
vyfakturuj_get_invoice | 読み取り | 請求書を取得 |
vyfakturuj_create_invoice | 書き込み | 請求書を作成(実際の番号が付いた書類を発行します) |
vyfakturuj_list_contacts | 読み取り | 連絡先の一覧を取得 |
vyfakturuj_get_contact | 読み取り | 連絡先を取得 |
vyfakturuj_create_contact | 書き込み | 連絡先を作成 |
vyfakturuj_get_template | 読み取り | 定期請求書のテンプレートを取得 |
vyfakturuj_list_payment_methods | 読み取り | 支払い方法の一覧を取得 |
vyfakturuj_list_number_series | 読み取り | 番号体系の一覧を取得 |
vyfakturuj_list_tags | 読み取り | タグの一覧を取得 |
vyfakturuj_usage_status | メタ | 使用状況(無料プランの利用量) |
vyfakturuj_request_feature | メタ | 不足している機能をリクエスト |
vyfakturuj_upgrade | メタ | Pro にアップグレード(無制限*) |
vyfakturuj_cancel_subscription | メタ | Pro サブスクリプションを解約 |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で確認が必要です。meta ツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| Free | $0 | 月あたりツール呼び出し 50 回 |
| Pro(ユーザーごと) | $9/mo または $90/yr(2 か月分無料) | 無制限* |
*Pro には、このサーバーで月あたりツール呼び出し 10,000 回のフェアユース上限があります。それ以上必要な場合は、[email protected] までご連絡ください。
Pro が適用されるのはこのサーバーのみです。vyfakturuj_upgrade を使って登録してください(Stripe Checkout のリンクが返されます)。vyfakturuj_cancel_subscription でいつでも解約できます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。また、その前に vyfakturuj_upgrade を実行すると、解約は取り消されます。[email protected] までご連絡いただくこともできます。
ライセンス
MIT © usefulapi。Vyfakturuj との提携関係はなく、同社による推奨も受けていません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。