Neural Draft

Neural Draft MCP サーバー（@neuraldraft/mcp）

AI で構築するサイトのバックエンドです。CMS、ブログ、予約、フォーム、ショップ、ソーシャル機能を備え、クライアントごとにデータベースを用意します。コーディングアシスタントがサイトの構築中に CMS を設定し、クライアントはウェブエディターまたは Claude を使って編集できます。

@neuraldraft/mcp は、Neural Draft 用の Model Context Protocol サーバー（stdio、MIT）です。ワークスペース API キーを使って Claude Code、Cursor、Codex、または VS Code に追加すると、アシスタントはクライアントのサイトを構築しながら、次のことができます。

• コードを一行書く前に、ブランド（トーン、対象ユーザー、色、フォント、言語）を読み取ります。
• SEO メタデータ付きのページを作成し、編集可能なコンテンツキーとコンポーネントを登録します。クライアントはあなたに頼らず、Neural Draft エディターでテキストや画像を変更できます。
• 独自のデザインで、ホストされているサイトにページやサブページを追加し、メニューリンクを設定します。
• 予約可能なサービス、ギャラリー、ブログの下書きを設定し、商品、フォーム送信、ニュースレター登録を読み取ります。
• 1 つのサーバーから複数のクライアントワークスペースを操作します（代理店向け）。

各クライアントは、それぞれ専用の Postgres データベース、API キー、チームを持つ独立した Neural Draft ワークスペースです。キーでアクセスできるのは、そのキーが属するワークスペースだけです。

インストール

Node 20 以降とワークスペース API キーが必要です。Neural Draft の管理画面で、Settings → For developers → API keys（ndsk_live_…）から取得してください。無料プランが含まれており、クレジットカードは不要です。

Claude Code

claude mcp add neuraldraft-dev -e NEURALDRAFT_API_KEY=ndsk_live_... -- npx -y @neuraldraft/mcp

--scope project を追加すると、プロジェクトの .mcp.json に書き込まれます。環境変数参照を使って、キーを Git に含めないようにしてください。

{
  "mcpServers": {
    "neuraldraft-dev": {
      "command": "npx",
      "args": ["-y", "@neuraldraft/mcp"],
      "env": { "NEURALDRAFT_API_KEY": "${NEURALDRAFT_API_KEY}" }
    }
  }
}

/mcp を実行して接続を確認します。

Cursor

.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）：

{
  "mcpServers": {
    "neuraldraft-dev": {
      "command": "npx",
      "args": ["-y", "@neuraldraft/mcp"],
      "env": { "NEURALDRAFT_API_KEY": "ndsk_live_..." }
    }
  }
}

Codex

codex mcp add neuraldraft-dev --env NEURALDRAFT_API_KEY=ndsk_live_... -- npx -y @neuraldraft/mcp

または ~/.codex/config.toml：

[mcp_servers.neuraldraft-dev]
command = "npx"
args = ["-y", "@neuraldraft/mcp"]
env = { NEURALDRAFT_API_KEY = "ndsk_live_..." }

VS Code

.vscode/mcp.json：

{
  "servers": {
    "neuraldraft-dev": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@neuraldraft/mcp"],
      "env": { "NEURALDRAFT_API_KEY": "ndsk_live_..." }
    }
  }
}

Continue

~/.continue/config.yaml：

mcpServers:
  - name: neuraldraft-dev
    command: npx
    args: ["-y", "@neuraldraft/mcp"]
    env:
      NEURALDRAFT_API_KEY: ndsk_live_...

複数のクライアントワークスペース（代理店向け）

各クライアントは、それぞれ独自のワークスペースとキーを持ちます。それらすべてを 1 つのサーバーに登録し、list_workspaces / switch_workspace を使って切り替えます。ほかのすべてのツールは、アクティブなワークスペースを操作します。

{
  "mcpServers": {
    "neuraldraft-dev": {
      "command": "npx",
      "args": ["-y", "@neuraldraft/mcp"],
      "env": {
        "NEURALDRAFT_API_KEYS": "linden-bakery=ndsk_live_...,villa-lavanda=ndsk_live_...",
        "NEURALDRAFT_WORKSPACE": "linden-bakery"
      }
    }
  }
}

NEURALDRAFT_API_KEYS は JSON オブジェクト（{"linden-bakery":"ndsk_live_..."}）にも対応しています。複数のワークスペースを参照してください。

環境変数

変数	必須	備考
NEURALDRAFT_API_KEY	どちらか一方	1 つのワークスペースキー、ndsk_live_…
NEURALDRAFT_API_KEYS	どちらか一方	複数のワークスペース：name=key,name=key または JSON オブジェクト
NEURALDRAFT_WORKSPACE	いいえ	起動時にアクティブにする NEURALDRAFT_API_KEYS の項目（デフォルト：最初の項目）
NEURALDRAFT_API_URL	いいえ	デフォルトは https://api.neuraldraft.io/v1
NEURALDRAFT_PROJECT_ID	いいえ	1 つのキーが複数のプロジェクトにまたがる場合に上書きします
NEURALDRAFT_DISPLAY_NAME	いいえ	クライアントのサーバー一覧に表示する名前

NEURAL_DRAFT_* 形式も別名として使用できます。キーがない場合や形式が不正な場合は、動作する設定を示すメッセージとともに起動に失敗します。キーをコミットしないでください。

リモート／ホステッドコネクター

Neural Draft は、API キーもインストールも不要な、ホステッドリモート MCP サーバーとしても動作します。

https://neuraldraft.io/mcp

OAuth サインイン（Google またはメールで届くコード）に対応したストリーミング可能な HTTP を使用します。Claude、ChatGPT、Codex、Claude Code、Cursor、VS Code で利用でき、このパッケージでは対応していない機能も追加されます。ビルドのデプロイ（deploy_site、rollback_site）、カスタムドメイン、公開中のサイトテキストの編集、予約と空き状況、ブログ、ソーシャルメディアへの投稿スケジュール設定、そして Batchcraft がブランド向けに制作する完成済みの広告やリール動画などです。AI による画像や動画の作成は提供していません。ブランド向けの完成済みの静止画広告やリール動画を制作します。

# Claude Code
claude mcp add --transport http neuraldraft https://neuraldraft.io/mcp
# Codex
codex mcp add neuraldraft --url https://neuraldraft.io/mcp && codex mcp login neuraldraft

Claude：Customize → Connectors → Add custom connector。ChatGPT：Settings → Apps → Add custom MCP server。URL を貼り付けてサインインしてください。各アプリでの設定方法：ホステッドコネクター。

	ホステッドコネクター	@neuraldraft/mcp（このリポジトリ）
認証	サインイン（OAuth）	ワークスペースごとの API キー
実行方式	リモート、ストリーミング可能な HTTP	npx を使用してローカルで実行（stdio）
最適な用途	サイトのホスティングとデプロイ、クライアントによる編集、ドメイン、ブログ、予約、ソーシャルメディア	コードベースの接続：ブランド、コンテンツキー、コンポーネント、ページ、ギャラリー
複数のクライアント	サインイン時にワークスペースを選択	NEURALDRAFT_API_KEYS

開発者は Claude Code または Codex に両方を追加することがよくあります。

ツール

グループ	ツール
ワークスペース	list_workspaces、switch_workspace、find_workspaces
ブランド	get_brand、update_brand
コンテンツ	create_translation_keys、get_content、list_content、delete_content、register_component、delete_component
ページ	create_page、list_pages、get_page、update_page、delete_page、add_site_page
画像とギャラリー	list_images、get_image、register_image、replace_image（URL による）、delete_image、list_galleries、get_gallery、create_gallery、update_gallery、delete_gallery
ブログ	generate_blog_post（ブランドのトーンに合わせた下書き）、list_blog_posts、get_blog_post、update_blog_post
予約とショップ	create_bookable_service、setup_booking_widget、list_products、get_product
フォーム	list_newsletter_subscribers、list_contact_form_submissions
アカウント	get_usage、get_job

generate_image と generate_video は古いクライアント向けに引き続き登録されていますが、廃止されています。API はこれらに対して 410 media_generation_moved を返します。

リソース

URI	内容
brand://current	トーン、対象読者、色、フォント、言語。UI を生成する前に読み取ってください。
schema://blog-post	ブログ投稿のレスポンス形式
schema://product	商品とバリエーションの形式
schema://booking	サービス、予約、空き状況
conventions://editable-html	data-translate／data-image-key のマークアップ規則
conventions://api-usage	認証、エラー、レート制限、ジョブ

プロンプト

プロンプト	機能
/scaffold-marketing-site	Neural Draft と連携するマーケティングサイト一式（ブランド、編集可能なキー、コンポーネント）
/scaffold-blog-page	既存プロジェクトに /blog の一覧ページと投稿ページを作成
/connect-existing-site	既存の静的サイトを Neural Draft で編集可能にする

全リファレンス：ツール、リソース、プロンプト。

試してみる

brand://current を読み取り、このサイト用に編集可能なキーを使ってヒーローとサービスのセクションを作成し、Neural Draft に登録してください。

アシスタントはブランドを読み取り、data-translate と data-image-key を含むマークアップを作成し、キーを作成してセクションを登録します。これにより、クライアントの管理画面で編集できるようになります。

ドキュメント

• MCP の概要とセットアップ
• 編集可能なマークアップ
• REST APIと TypeScript SDK @neuraldraft/sdk
• 開発者とエージェンシー向け

ローカル開発

git clone https://github.com/vbalagovic/neuraldraft-mcp.git
cd neuraldraft-mcp
npm install
npm run lint    # tsc --noEmit
npm test
npm run build   # → dist/

ローカル API に接続して実行します：

NEURALDRAFT_API_KEY=ndsk_test_xxx NEURALDRAFT_API_URL=http://localhost:8080/v1 npm run dev

MCP Inspector で検査します：npx @modelcontextprotocol/inspector node dist/index.js。

このサーバーは Neural Draft Project API v1 を薄くラップするものです。各ツールは 1 つまたは数個の REST 呼び出しに対応します。実行時に stdout へ出力することはありません（stdio トランスポート）。

コントリビューション

Issue や PR を歓迎します。テスト（npm test）が通る状態を保ち、新しいツールには既存の register* ヘルパーパターンを使用してください。また、新しい機能を追加した場合は上記の表を更新してください。

ライセンス

MIT

---

Neural Draft によって開発されました。お問い合わせ：[email protected]。