Artesa MCP by usefulapi

usefulapi による Artesa MCP

Artesa アカウントを Claude、Cursor、または任意の MCP クライアントから利用できます。顧客、担当業務、スタッフ、時間記録、休暇を参照し、顧客を作成できます。ホスト型のため、ローカルへのインストールは不要です。ご自身の認証情報で接続できます。

稼働中のエンドポイント： https://artesa.usefulapi.io/mcp · ホームページ： https://usefulapi.io

接続

• Claude（claude.ai、デスクトップ）：Customize → Connectors を開き、+ Add → Add custom connector をクリックして、https://artesa.usefulapi.io/mcp を貼り付けます。
• Claude Code： claude mcp add --transport http artesa https://artesa.usefulapi.io/mcp を実行し、続いて /mcp を実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： URL をリモート MCP サーバーとして追加します。

{
  "mcpServers": {
    "artesa": {
      "url": "https://artesa.usefulapi.io/mcp"
    }
  }
}

URL だけを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーは OAuth でサインインし、ログインページで Artesa の認証情報を求めます。

ステップごとの設定手順、認証情報の確認方法、よくある質問：https://usefulapi.io/artesa/

初回接続時に Artesa API キーを入力します（Artesa → Settings。管理者アカウントが必要です）。サーバーがキーを検証し、ユーザーごとに保存します。設定ファイルにキーを記載する必要はありません。

ツール

ツール	種類	機能
artesa_list_customers	読み取り	顧客の一覧を取得
artesa_get_customer	読み取り	顧客を取得
artesa_create_customer	書き込み	顧客を作成
artesa_list_assignments	読み取り	担当業務の一覧を取得
artesa_get_assignment	読み取り	担当業務を取得
artesa_list_assignment_events	読み取り	担当業務イベントの一覧を取得
artesa_get_assignment_event	読み取り	担当業務イベントを取得
artesa_list_projects	読み取り	プロジェクトの一覧を取得
artesa_get_project	読み取り	プロジェクトを取得
artesa_list_users	読み取り	ユーザーの一覧を取得
artesa_get_user	読み取り	ユーザーを取得
artesa_list_time_entries	読み取り	時間記録の一覧を取得
artesa_list_user_absences	読み取り	ユーザーの休暇一覧を取得
artesa_list_time_sheet_weeks	読み取り	タイムシート週の一覧を取得
artesa_list_assignment_status_types	読み取り	担当業務のステータス種別一覧を取得
artesa_list_assignment_types	読み取り	担当業務の種別一覧を取得
artesa_list_gangs	読み取り	グループの一覧を取得
artesa_list_roles	読み取り	ロールの一覧を取得
artesa_usage_status	メタ	使用状況（無料プランの利用量）
artesa_request_feature	メタ	不足している機能をリクエスト
artesa_upgrade	メタ	Pro にアップグレード（無制限*）
artesa_cancel_subscription	メタ	Pro サブスクリプションをキャンセル

read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で確認を求める必要があります。meta ツールは使用状況を報告し、サブスクリプションを管理するか、機能リクエストを送信します。

料金

プラン	料金	上限
Free	$0	月あたり 50 回のツール呼び出し
Pro（ユーザーごと）	$9/mo または $90/yr（2 か月分無料）	無制限*

*このサーバーでの Pro のフェアユース上限は、月あたり 10,000 回のツール呼び出しです。それ以上必要な場合は、[email protected] までお問い合わせください。

Pro はこのサーバーのみが対象です。artesa_upgrade で登録すると、Stripe Checkout のリンクが返されます。artesa_cancel_subscription でいつでもキャンセルできます。Pro は有料期間の終了まで利用でき、現在の期間分の返金はありません。その前に artesa_upgrade を実行すると、キャンセルが取り消されます。または、[email protected] までお問い合わせください。

ライセンス

MIT — LICENSE をご覧ください。ドキュメントのみです。サーバーはホストされています。