Simplifier Mcp

Simplifier MCP サーバー

Simplifier は SAP エコシステムをリードするローコードプラットフォームです。フルスタックのローコードクラウド開発環境でカスタムアプリを構築し、本格的なコーディングへの依存を減らせます。標準化されたコネクターを使って、ERP、CRM、その他のシステムと簡単に連携できます。

詳しくはコミュニティをご覧いただくか、Simplifier を無料でお試しください。

---

このリポジトリには、AI アシスタントと**Simplifier Low Code Platform**との連携を可能にする MCP サーバー（Model Context Protocol）が含まれています。Simplifier のコネクターと BusinessObject の作成および管理に役立つツールとリソースを提供します。

概要

Simplifier MCP サーバーを使用すると、Simplifier インスタンスと連携して次の操作を行えます。

• コネクターとログイン情報の管理：外部システムと接続する連携コンポーネントです
• ビジネスオブジェクトの管理：ビジネスロジックを担う、サーバー側で実行される JavaScript 関数です
• データ型の管理：コネクターや内部オブジェクトとの連携に使用するデータ構造です
• ビジネスオブジェクト関数の実行：パラメーターを指定して JavaScript 関数を実行し、結果を取得します
• コネクター呼び出しの実行：Simplifier コネクターを介して外部システムを呼び出します
• プラットフォームリソースへのアクセス：コネクター、ビジネスオブジェクト、システム情報を参照します

サポート対象のコネクタータイプ

現在、完全にサポートされているコネクタータイプは次のとおりです。

• REST
• SOAP
• SQL
• SAPRFC
• OData（プロキシのみ。コネクター呼び出しには対応していません）

クライアントの互換性

Simplifier MCP サーバーは、MCP クライアントがサポートする MCP プロトコルの機能にかかわらず、すべての MCP クライアントがデータを完全に利用できるよう、2 つの並行したインターフェースを通じてデータを公開します。

• MCP リソースを実装するクライアント（Claude Code、Claude Desktop、MCP Inspector など）は、simplifier://… URI を介して Simplifier のデータを参照および読み取れます。例：simplifier://businessobjects、simplifier://connector/{name}、simplifier://documentation/…。
• MCP ツールのみを実装するクライアント（OpenCode、Cursor、Cline、Continue、Windsurf など）は、*-list、*-get、documentation-get、connector-wizard-rfc-searchという名前のツールを通じて、同等の読み取りアクセスを利用できます。

どちらのインターフェースも同じ基盤実装を共有しているため、動作は同じです。両方を利用できる場合は、クライアントにはリソースの使用を推奨します。

使用方法

MCP サーバーの最適な使用方法とセットアップについては、Simplifier Community Docsをご覧ください。

認証

認証には、個人用アクセストークン（PAT）の使用を推奨します（Simplifier Version MC 26-11 以降）。SIMPLIFIER_APITOKENを通じて指定してください。 このトークンはApiTokenヘッダーとして Simplifier に送信され、ログインのたびに変わることはないため、一度設定すれば毎日更新する必要はありません。以下の例ではすべてSIMPLIFIER_APITOKENを使用しています。

代わりに、次の環境変数のいずれかを使用することもできます。

• SIMPLIFIER_TOKEN：現在の SimplifierToken です。Simplifier にログインするたびに変わります（Simplifier への再ログイン後を参照してください）。
• SIMPLIFIER_CREDENTIALS_FILE：userとpassを含む JSON ファイルのパスです。起動時に Simplifier へのログインに使用されます。

SIMPLIFIER_APITOKEN、SIMPLIFIER_TOKEN、SIMPLIFIER_CREDENTIALS_FILEのうち、設定できるのは1つだけです。

claude code に MCP を追加する方法 ...

node / npx を使用する場合：

claude mcp add simplifier npx @simplifierag/simplifier-mcp@latest --env SIMPLIFIER_APITOKEN=<your personal access token> --env SIMPLIFIER_BASE_URL=https://<yourinstance>-dev.simplifier.cloud

Docker を使用する場合：

claude mcp add simplifier-docker docker -- run --rm -i --env SIMPLIFIER_APITOKEN=<your personal access token> --env SIMPLIFIER_BASE_URL=https://<yourinstance>-dev.simplifier.cloud simplifierag/simplifier-mcp:latest

Simplifier がオンプレミス環境でホストされている場合、DEV インスタンスのSIMPLIFIER_BASE_URLは、記載されているスキーマとは異なります。

Simplifierへの新しいログイン後

これは、個人用アクセストークンの代わりにSIMPLIFIER_TOKENを使用する場合にのみ適用されます。 Simplifierにログインするたびに、SimplifierTokenが変わります。そのため、次の手順が必要です。

• AI エージェント（この例ではclaude）を終了します。
• 次に、MCPの設定を削除します。

claude mcp remove simplifier

• その後、SIMPLIFIER_APITOKENの代わりに--env SIMPLIFIER_TOKEN=<your current simplifier token>を指定して（上記のコマンドを参照）、MCPを再度追加し、AI エージェントを再起動します。

...または、MCPを使用するためのclaude code用の設定例を使用します

例：claudeを起動するディレクトリに配置した、.mcp.jsonという名前のファイル。

node / npxを使用する場合：

{
  "mcpServers":  {
    "simplifier-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [ 
        "@simplifierag/simplifier-mcp@latest"
      ],
      "env": {
        "SIMPLIFIER_BASE_URL": "https://<yourinstance>-dev.simplifier.cloud",
        "SIMPLIFIER_APITOKEN": "<your personal access token>"
      }
    }
  }
}

Dockerを使用する場合：

{
  "mcpServers": {
    "simplifier-docker": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "SIMPLIFIER_APITOKEN",
        "--env",
        "SIMPLIFIER_BASE_URL",
        "simplifierag/simplifier-mcp:latest"
      ],
      "env": {
        "SIMPLIFIER_BASE_URL": "https://<yourinstance>-dev.simplifier.cloud",
        "SIMPLIFIER_APITOKEN": "<your personal access token>"
      }
    }
  }
}

トラブルシューティング

起動時にMCPがSimplifierへの接続に失敗すると、失敗の詳細と問題の解決方法を記載したエラーページが ブラウザーで開きます。