ClaudeからSoftr MCPで業務アプリを作る手順 — 権限と公開の注意

Softr MCPサーバーは、ノーコードツールSoftrのワークスペースをClaudeから操作するための接続口です。URLはhttps://mcp.softr.io/mcpの1つだけで、インストールもAPIキーの貼り付けも要りません。

つなげば、データベースの作成、アプリとページの追加、ワークフローの構築、そして公開までを会話で進められます。ただし公開と削除には戻せない操作が含まれます。この記事では、接続の手順に加えて、その手前で権限をどう絞るかを中心に扱います。

Softr MCPでClaudeに任せられる範囲

操作は5つの領域に分かれます。ワークスペースを頂点に、アプリ・データベース・ワークフロー・連携がぶら下がる構造です。

操作は自分の権限で行われ、Softr Studio上にも通常の変更として表示されます。Softr AIクレジットは消費されず、使うのはClaude側のモデルと利用枠です。

ここで押さえておきたいのは、ページの中身を作る手段です。Claudeが追加できるのは空のページで、中身はバイブコーディングブロック(React製のカスタムブロック)経由で入れる設計になっています。MCPから追加できるのは空のページとバイブコーディングブロックだけです。

接続前に決める権限

Softrの認可画面では、対象ワークスペースと、3つの領域ごとのアクセスレベルを選びます。AIツール側から権限を事前に要求することはできず、必ずこの画面で人間が決めます。

レベルは束ねられた単位で、個別に足し引きできません。編集を許可すれば読み取りも付き、スキーマ変更を許可すればレコード操作も付きます。

削除は編集に付いてきます。「Edit data」でレコードを、「Full access」でフィールド・テーブル・データベースごと消せます。削除を一切許したくない接続なら、データベースはView onlyにします。Softrのデータベースにはゴミ箱がなく、消したデータは戻りません。

実運用では、段階を分けて使うのが現実的です。

• 最初の接続: データベースを「View only」、アプリを「Read only」にして、構造を読ませる
• 設計の確定後: アプリを「Full access」に上げ、データベースは「Edit data」まで
• スキーマ変更が要るとき: その作業の間だけデータベースを「Full access」にする

レベルの変更は、アカウントメニューのAPI tokensから後でできます。

Claudeに接続する手順

接続口は使うClaudeの面によって異なります。同じMCPサーバーURLを、Claudeのウェブ版・デスクトップアプリ・Coworkではカスタムコネクタとして、Claude Codeではコマンドで登録します。

Claudeのウェブ版・デスクトップアプリ・Coworkの場合

Client IDを求められた場合は、Claude(claude.ai)向けに登録済みのIDが用意されています。Client Secretは空欄のままにします。

Claude Codeの場合

claude mcp add --transport http softr \
  https://mcp.softr.io/mcp --scope user

--scope userを付けると、現在のプロジェクトに限らずどこからでも使えます。付けなければ現在のプロジェクト(local scope)だけです。登録後は、Claude Code内で/mcpを開いてsoftrを選び、Authenticateを押します。ブラウザにSoftrの認可画面が開きます。認証前のclaude mcp listにはNeeds authenticationと表示されます。

サーバー名をsoftrにしたので、Claude Code側の権限ルールではmcp__softr__<ツール名>の形で指定できます。ルールの書き方の詳細はClaude CodeのMCP権限ルールにまとめています。

権限ルールで公開と削除に確認を挟む

Softr側のレベルは「何ができるか」の上限を決めます。Claude Code側では「どの呼び出しで毎回確認を取るか」を足せます。公開と削除は、Softr側で許可していても確認を挟む価値があります。

次は、プロジェクトの.claude/settings.jsonに置く例です。

{
  "permissions": {
    "allow": [
      "mcp__softr__list_*",
      "mcp__softr__get_*",
      "mcp__softr__search_records",
      "mcp__softr__preview_app"
    ],
    "ask": [
      "mcp__softr__publish_app",
      "mcp__softr__publish_workflow",
      "mcp__softr__delete_*"
    ]
  }
}

読み取り系を事前許可し、公開と削除は毎回尋ねる構成です。許可ルールのワイルドカードはmcp__softr__の後ろにだけ使えます。delete_*にはレコード・フィールド・テーブル・データベースの削除ツールがまとめて掛かり、delete_recordsのような一括削除も含まれます。

preview_appを許可に入れたのは、閲覧用のリンクを作るだけで公開はしないからです。ただしこのリンクは後述するとおり資格情報と同じ扱いになります。

業務アプリを会話で組み立てる流れ

例として、営業案件を管理する社内アプリを作ります。以下の依頼文は、Softr側の各ツールが担う作業に対応させた例示です。

レコードの追加や集計は、アプリの完成を待たず、データベースの段階から会話で試せます。「受注済みの案件を金額順に並べて」「フェーズ別の合計金額を出して」といった質問は、集計ツールで1回の呼び出しになります。集計のグループ化は2フィールドまでです。

一度に読めるレコードは200件、一括作成と一括削除は1回100件が上限です。大きなテーブルでは、全件を読ませるより、条件を付けた検索か集計を頼むほうが少ないやり取りで済みます。

公開で起きること — 戻せない操作を先に知る

アプリの公開には、手順書の上では1行の依頼で済むぶん、先に知っておきたい性質があります。

プレビューについても注意があります。プレビューのリンクは単なるアドレスではなく、開いた人を依頼した本人としてログインさせます。有効期間は約1日で、チャットやチケットに貼らないようにします。最新の変更を見るには、毎回新しいリンクを発行します。

サブドメインやカスタムドメインの変更、ログインの有効化・無効化、サインアップ方針の設定も、次回の公開まで反映されません。サインアップを社内向けに絞りたいときは、DOMAIN_RESTRICTEDでメールのドメインを指定します。

ユーザーまわりにも落とし穴があります。

• ユーザーテーブルを接続しても、ログインは有効になりません。ログインの設定は別の操作です
• アプリにユーザーが残っている間は、ログインを無効にできません
• ユーザーグループは、渡したメンバー一覧や条件で丸ごと置き換わります。「Danaを追加して」は、現在の一覧を読んでDanaを足した全体を送り返す動きになるため、結果の確認が要ります
• 存在しないフィールドを指す条件のグループは、エラーも出さず誰にも一致しません
• ユーザーを一時的に止めたいなら、削除ではなく無効化を使います。無効化したユーザーはログインできませんが、アカウントとデータは残ります

ワークフローを頼むときの注意

「新規注文が入ったらSlackに通知する」のようなワークフローも、会話で組めます。組み方は、トリガーを選び、ステップを1つ足し、入力を埋め、テストし、次へ進む、という順です。

注意点が3つあります。

1. 前のステップの出力を後のステップで使えるのは、そのステップのテストを通してからです。最後のステップも含め、全ステップにテスト成功が要ります
2. モックデータで試せないステップは、テストが本番の呼び出しになります。メールの送信や行の書き込みが実際に起きます
3. 分岐の追加はできても、各経路へ進む条件はMCPから設定できません。条件の指定はビルダーで仕上げます

ワークフローは公開しなければ動きません。公開は有効化のことで、停止してもステップは残ります。

つまずいたときの切り分け

トークンはAPI tokensの画面から、編集・再発行・削除ができます。OAuthで接続したツールはAuthorized appsに並び、Revokeを押すと、そのツールに発行済みのトークンが直ちに無効になります。この欄は、OAuthで認可したツールが1つ以上あるときだけ表示されます。

似た手段との使い分け

SoftrのMCPサーバーは、アプリを作る人のためのものです。作ったアプリを使う側のユーザーが、自分のAIアシスタントから操作する用途には、別のサーバー(App MCP server)が用意されています。

Softrのように公式のMCPサーバーがある業務ツールなら、リモートMCPをそのまま登録するのが最短です。公式のサーバーがないSaaSをつなぐ場合は、業務SaaS MCP連携ガイドの自作手順が参考になります。Coworkで社内システムにつなぐ場合の考え方は、Coworkカスタムコネクタ自作ガイドにあります。MCPサーバー全般の設定はClaude CodeのMCPサーバー設定ガイドで扱っています。

まとめ

Softr MCPの要点は、権限の3領域を接続時に絞ることと、公開・削除という戻せない操作に確認を挟むことの2点です。最初は読み取り中心の権限で構造を読ませ、設計が固まってから編集権限へ上げる進め方なら、取り返しのつかない変更をかなり避けられます。

ページの中身がバイブコーディングブロック経由になる点、ワークフローの分岐条件がビルダーでの作業になる点は、依頼を組み立てる前に頭に置いておくと手戻りが減ります。