MCPサーバー

概要

TesseraはMCP（Model Context Protocol）サーバーとして動作し、Claude Code・CursorなどのAIエージェントから、スキーマ（コンテンツタイプ定義）とコンテンツの両方を直接操作できます。

汎用LLMラッパーとの違いは、Tesseraが「CMSの構造そのもの」を理解した状態でツールを提供している点です。たとえばスキーマ変更の提案（propose_content_type_change）は、既存のフィールド構成・既存コンテンツの実データを踏まえて検証されます。「必須フィールドに変更しようとしたが、既存コンテンツに値が入っていないものがある」といったケースは、AIが気づかなくてもTessera側が機械的に検知して提案を拒否します（詳細は下記「エラーケース」参照）。

Claude Code/Cursorに接続すると、AIエージェントは以下のようなことができるようになります。

• 既存のスキーマ・コンテンツを参照しながら、コンテンツタイプの新規作成・変更・削除を提案する
• コンテンツの作成・検索・更新・削除を行う
• 既存コンテンツがスキーマ定義と整合しているか（不整合な値・参照切れ等）をオンデマンドで検査する
• 下書きコンテンツのプレビュー用リンクを発行する
• 画像・PDF等のメディアアセットをアップロードする

スキーマ変更は常にステージングされ、AIエージェントが直接確定させることはできません。 propose_content_type_changeはバリデーションを通過しても即座には反映されず、必ず承認待ち（pending_approval）としてステージングされます。反映には、管理画面（/entries）上での人間による承認が必須です。承認・却下自体はMCPツールとして提供していません（意図的な設計）。

クイックスタート

1. /settings/api-keysから「+ APIキーを発行」を選択し、スコープ（read_only / read_write）を選んでAPIキーを発行します。read_writeを選ぶと、コンテンツのCRUDに加えてスキーマ変更提案（propose_content_type_change）も実行できるようになります。コンテンツタイプ単位で個別に権限を上書きしたい場合（例: 特定のコンテンツタイプだけ書き込み禁止にする）は、発行画面の「コンテンツタイプ単位の例外を追加」から設定できます。この設定は発行後もAPIキー一覧画面から追加・変更・削除が可能です。
2. Claude Code・CursorなどMCP対応のAIエージェント側の設定ファイル（.mcp.json）に以下を追記します。

{
  "mcpServers": {
    "tessera": {
      "type": "http",
      "url": "https://YOUR_WORKSPACE.tesseracms.example.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

3. 設定ファイルを保存し、Claude Code/Cursorを再起動（または再読み込み）します。/mcpコマンドでtesseraへの接続状態を確認できます。
4. 接続後、read_writeスコープのキーであれば、AIエージェントからコンテンツの作成・更新・削除、コンテンツタイプ（スキーマ）の変更提案が行えます。read_onlyスコープのキーでは、書き込み系ツールはそもそもツール一覧に表示されません（AIエージェントに「書き込みができる」という誤った期待を持たせない設計です）。
5. 濫用防止のため、MCP経由の呼び出しには回数の上限があります（プランにより異なります。詳細は下記「コスト・利用上限」参照）。MCP経由の操作はLLM呼び出しを一切行わないため、AIクレジットの消費対象にはなりません。

利用可能なツール一覧（14種類）

読み取り系（7種類・read_onlyキーでも利用可能）

スキーマ操作系（read_writeキー、または対象コンテンツタイプへの書き込みオーバーライドが必要）

書き込み系（read_writeキー、または対象コンテンツタイプへの書き込みオーバーライドが必要）

list_content_types / get_content_typeは、コンテンツタイプ単位のオーバーライドで「アクセス遮断（none）」が設定されている対象を一覧・単体取得の両方から除外します（存在自体を見せません）。

実例

例1: スキーマ変更を提案し、承認画面へ直接遷移する

「blogPostにfeatured（真偽値、注目記事フラグ）を追加して」とAIエージェントに伝えると、propose_content_type_changeが呼ばれます。

// リクエスト（AIエージェント→Tessera）
{
  "mode": "update",
  "targetContentTypeApiId": "blogPost",
  "basedOnVersion": 3,
  "definition": { "apiId": "blogPost", "displayName": "ブログ記事", "fields": [ /* 既存フィールド + featured */ ] }
}

// レスポンス
{
  "status": "pending_approval",
  "proposalId": "b1e2c3d4-...",
  "mode": "update",
  "targetContentTypeApiId": "blogPost",
  "approvalUrl": "https://YOUR_WORKSPACE.tesseracms.example.com/entries#proposal-b1e2c3d4-...",
  "impact": { /* 影響分析: 型変更・必須化・削除等がある場合、影響を受ける既存コンテンツ件数を含む */ }
}

approvalUrlは、承認待ちの当該提案が表示された状態の管理画面へ直接遷移できるリンクです。人間はこのリンクを開いて差分を確認し、承認・却下を行います（承認操作自体はMCPツールとして提供していません）。

例2: 既存コンテンツとスキーマの不整合を検知する

「blogPostのデータに問題がないか確認して」と伝えると、check_content_consistencyが呼ばれます。

check_content_consistency({ contentTypeApiId: "articles" })

レスポンスの形状について: MCPプロトコル上は{ content: [{ type: "text", text: "..." }] }という形でさらに1段ラップされており、content[0].textの中身が以下のJSON文字列として埋め込まれています。以下は、その中身（ツールが返す論理的な値）を示しています。

• 正常時: { contentTypeApiId, issues }（issuesは不整合なしなら空配列。正常時はstatusキーが付きません）
• 対象コンテンツタイプが存在しない場合: { status: "not_found", contentTypeApiId }
• 権限がない場合: { status: "permission_denied", contentTypeApiId }

issues配列の各要素（ConsistencyIssue）の形状:

type ConsistencyIssueKind =
  | "type_mismatch"          // フィールドの型がスキーマ定義と不一致
  | "required_missing"       // required:trueなのに値が欠落(null/キー欠落)
  | "unique_violation"       // unique:trueなのに値が重複
  | "select_option_invalid"  // select型でoptionsに含まれない値
  | "dangling_reference";    // reference型で参照先コンテンツが実在しない

interface ConsistencyIssue {
  contentTypeApiId: string;
  fieldApiId: string;
  kind: ConsistencyIssueKind;
  affectedCount: number;      // 該当する不整合コンテンツの総件数
  sampleEntryIds: string[];   // 最大5件のサンプルコンテンツUUID(全件ではなく代表例)
}

実際のレスポンス例（unique制約違反を1件検出した場合）:

{
  "contentTypeApiId": "articles",
  "issues": [
    {
      "contentTypeApiId": "articles",
      "fieldApiId": "slug",
      "kind": "unique_violation",
      "affectedCount": 3,
      "sampleEntryIds": ["0b1f2b1a-1111-...", "0b1f2b1a-2222-...", "0b1f2b1a-3333-..."]
    }
  ]
}

このツールは読み取り専用で、スキーマ・コンテンツを変更しません。スキーマ変更前後で既存データとの整合性を事前確認したい場合に使います。

例3: 下書きコンテンツのプレビューリンクを発行する

「この下書き記事を編集部内で共有したい」と伝えると、create_preview_linkが呼ばれます。

// リクエスト
{ "contentTypeApiId": "blogPost", "entryId": "e5f6...", "expiresInDays": 3 }

// レスポンス
{
  "previewUrl": "https://YOUR_WORKSPACE.tesseracms.example.com/preview/e5f6...?token=...",
  "token": "tsr_prev_...",
  "expiresAt": "2026-07-10T00:00:00.000Z",
  "entryId": "e5f6...",
  "contentTypeApiId": "blogPost",
  "label": null
}

トークンはこのレスポンスの中でのみ平文表示されます（発行後の再表示は不可、/settings/previewからいつでも失効できます）。AI経由での発行は必ず有効期限が必要で、無期限リンクは選択できません（最大90日、未指定時は7日）。

エラーケース

{ "status": "permission_denied", "contentTypeApiId": "internalMemo" }

{
  "status": "rate_limited",
  "window": "hourly",
  "limit": 30,
  "message": "..."
}

コスト・利用上限

MCP経由の操作はAIクレジット（従量課金）の対象外です。 スキーマ変更の生成自体は、接続元のAIエージェント（Claude Code/Cursor等）側のモデルが行っており、Tesseraは確定済みの定義を受け取って検証・ステージングするだけです。Tessera側でLLM APIを呼び出す処理は/schema-chat（チャットAI）のみが対象で、MCP経由のツール呼び出しにLLM呼び出しは一切発生しません。

濫用防止・DB保護のため、回数ベースのレート制限があります（AIクレジットの消費量とは無関係です）。

読み取り系はGraphQL Queryと、コンテンツ書き込み系はGraphQL Mutationと、それぞれ同一の枠を共有します（チャネルを跨いで合算枠を突破できない設計です）。数値は将来の実測データに基づき見直される場合があります。

関連ドキュメント

• 認証・APIキー — セッションCookie/APIキーの認証方式、スコープ設計、コンテンツタイプ単位のオーバーライドについて
• 料金・クレジット — Free/Paidプランの詳細、AIクレジットの考え方について
• GraphQL API — MCPと並ぶもう一つのAPI接続方法について
• よくある質問（承認フローの安全性について）