claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialdevelopment

💳sumup-mcp

プラグイン
sumup
ライセンス
Apache-2.0

説明

次のような場合に使用: ユーザーがSumUp MCPに言及している場合、 `mcp.sumup.com` への接続が必要な場合、 またはSumUp APIへのツールベースのアクセスを求めている場合。 Cursor、Claude Code、Codex、またはMCP対応の任意のクライアントから、SumUp MCPサーバー(https://mcp.sumup.com/mcp)を利用します。

原文を表示

Use the SumUp MCP server (https://mcp.sumup.com/mcp) from Cursor, Claude Code, Codex, or any MCP-capable client. Use when the user mentions SumUp MCP, needs to wire mcp.sumup.com, or wants tool-based access to SumUp APIs.

ユースケース

  • ユーザーがSumUp MCPに言及している
  • mcp.sumup.com への接続が必要
  • SumUp APIへのツールベースのアクセスを求めている

本文(日本語訳)

SumUp MCP サーバーガイド

次のような場合に使用: SumUp MCP サーバーのセットアップまたは使用方法についてリクエストされた場合。

正規エンドポイント:

  • https://mcp.sumup.com/mcp

このスキルがカバーする範囲

  • MCP 対応クライアントへの MCP サーバー接続設定
  • 認証ハンドシェイクのトラブルシューティング
  • ツール駆動の SumUp API タスクに向けたプロンプトパターン
  • 本番環境およびサンドボックス環境における安全な使用のためのガードレール

最小構成チェックリスト

  1. sumup という名前で MCP サーバーエントリを追加する。
  2. URL を https://mcp.sumup.com/mcp に設定する。
  3. クライアントが明示的なトランスポートを必要とする場合は、Streamable HTTP トランスポートを使用する。
  4. クライアントから求められたら認証フローを完了する。
  5. 最初のタスクプロンプトを実行する前に、ツールが検出可能であることを確認する。

MCP サーバー設定の記述例

{
  "servers": {
    "sumup": {
      "url": "https://mcp.sumup.com/mcp",
      "transport": "streamable_http"
    }
  }
}

フィールド名は、対象クライアントの MCP 設定スキーマに合わせて適宜変更してください。

プロンプトパターン

  • 「過去 24 時間の SumUp マーチャントチェックアウトを一覧表示して。」
  • 「サンドボックスで 12.34 EUR のチェックアウトを作成し、チェックアウト ID を返して。」
  • 「このチェックアウト ID を調べて、ステータスの遷移を要約して。」
  • 「この参照番号の失敗した支払いを照合するために必要なデータを表示して。」

よくある障害パターン

サーバーに到達できない

  • URL とトランスポートが正確であることを確認する。
  • クライアントがアウトバウンド HTTPS を許可しているか確認する。
  • クリーンなセッションから再試行する。

認証ループまたは未認証エラー

  • 認証ハンドシェイクを再実行し、正しいアカウント・環境が使用されているか確認する。
  • トークン・セッションに必要なスコープが付与されているか確認する。

ツールが表示されない

  • クライアント上で MCP サーバーをリフレッシュ・リロードする。
  • サーバーエイリアスが、プロンプトや設定で期待される名前と一致しているか確認する。

安全性と信頼性に関するルール

  • シークレットや生のトークンをプロンプトやログに露出させない。
  • 新しいワークフローおよびリグレッションテストにはサンドボックスを優先して使用する。
  • 決済に関わる重要なアクションは、確定的な読み取りによって最終的なチェックアウトステータスを必ず確認する。
  • 監査性と照合のために、チェックアウト ID・参照番号を記録しておく。

必須レスポンス要件

MCP のセットアップ・使用に関するリクエストへの回答には、以下を含めること:

  1. 正確なサーバー設定スニペット。
  2. 認証手順と、一般的に失敗が発生する箇所の説明。
  3. セットアップが正常に完了したことを確認するための検証コマンドまたはプロンプト。
  4. 本番環境で使用する前に、サンドボックスで実行する安全な最初のタスク。
原文(English)を表示

SumUp MCP Server Guide

Use this skill when setup or usage of the SumUp MCP server is requested.

Canonical endpoint:

  • https://mcp.sumup.com/mcp

What this skill covers

  • MCP server wiring in MCP-capable clients
  • Auth handshake troubleshooting
  • Prompt patterns for tool-driven SumUp API tasks
  • Safe usage guardrails for production and sandbox contexts

Minimal Setup Checklist

  1. Add an MCP server entry named sumup.
  2. Set URL to https://mcp.sumup.com/mcp.
  3. Use streamable HTTP transport if the client requires explicit transport.
  4. Complete authentication flow when prompted by the client.
  5. Confirm tools are discoverable before first task prompt.

Example MCP Server Declaration

{
  "servers": {
    "sumup": {
      "url": "https://mcp.sumup.com/mcp",
      "transport": "streamable_http"
    }
  }
}

Adapt field names to the target client's MCP config schema.

Prompt Patterns

  • "List my SumUp merchant checkouts from the last 24 hours."
  • "Create a sandbox checkout for 12.34 EUR and return the checkout id."
  • "Inspect this checkout id and summarize status transitions."
  • "Show what data is needed to reconcile failed payments for this reference."

Common Failure Modes

Server not reachable

  • Confirm exact URL and transport.
  • Check client allows outbound HTTPS.
  • Retry from a clean session.

Auth loop or unauthorized

  • Re-run auth handshake and ensure correct account/environment.
  • Confirm the token/session has required scopes.

Tools not appearing

  • Refresh/reload MCP server in client.
  • Confirm server alias matches the expected name in prompts/config.

Safety and Reliability Rules

  • Never expose secrets or raw tokens in prompts or logs.
  • Prefer sandbox for new workflows and regression tests.
  • For payment-critical actions, verify final checkout status through deterministic reads.
  • Record checkout ids/references for auditability and reconciliation.

Required Response Contract

When answering MCP setup/use requests, include:

  1. Exact server configuration snippet.
  2. Authentication steps and where failures usually happen.
  3. One verification command/prompt to confirm setup.
  4. A safe first task in sandbox before production usage.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。