NodeFlare ドキュメント

クイックスタート

5分でMCPサーバーをデプロイする手順を説明します。

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new McpServer({
  name: "my-server",
  version: "1.0.0",
});

// ツールを定義
server.tool("hello", "挨拶を返す", {
  name: { type: "string", description: "名前" }
}, async ({ name }) => {
  return {
    content: [{ type: "text", text: `こんにちは、${name}さん！` }]
  };
});

// サーバー起動
const transport = new StdioServerTransport();
await server.connect(transport);

from mcp.server import Server
from mcp.types import TextContent

server = Server("my-server")

@server.tool("hello", description="挨拶を返す")
async def hello(name: str) -> list[TextContent]:
    return [TextContent(type="text", text=f"こんにちは、{name}さん！")]

if __name__ == "__main__":
    server.run()

{
  "name": "my-mcp-server",
  "version": "1.0.0",
  "type": "module",
  "main": "dist/server.js",
  "scripts": {
    "build": "tsc",
    "start": "node dist/server.js"
  },
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.0"
  },
  "devDependencies": {
    "typescript": "^5.0.0"
  }
}

mcp>=1.0.0

サーバーの作成

対応言語・ランタイム

リポジトリの要件

• package.json にMCP SDKが依存関係として含まれていること
• build スクリプトと start スクリプトが定義されていること
• エントリーポイントが main フィールドで指定されていること

サーバー設定

デプロイ

自動デプロイ

指定したブランチにpushすると、自動的にビルド・デプロイが実行されます。 GitHub Webhookにより、コードの変更を検知して即座にデプロイを開始します。

ビルドプロセス

1. リポジトリのクローン
2. npm install で依存関係をインストール
3. npm run build でビルド
4. コンテナイメージの作成
5. デプロイ・起動

デプロイステータス

ビルドが失敗した場合

ダッシュボードのログタブでビルドログを確認できます。よくある原因：

• 依存関係のインストールエラー
• TypeScriptの型エラー
• エントリーポイントの指定ミス

マルチリージョン

MCPサーバーを複数のリージョンにデプロイすることで、グローバルなユーザーに低レイテンシーでサービスを提供できます。

利用可能なリージョン

リージョンの追加

1. ダッシュボードでサーバーを選択
2. 「リージョン」タブを開く
3. 追加したいリージョンを選択
4. 確認後、自動的にデプロイが開始されます

料金

追加リージョンはプランに応じて料金が発生します。詳細は料金プランをご確認ください。 Proプラン以上で追加リージョンが利用可能です。

環境変数・シークレット

APIキーやデータベース接続情報などの機密情報は、シークレットとして暗号化して保存できます。

シークレットの追加

1. ダッシュボードでサーバーを選択
2. 「シークレット」タブを開く
3. 「シークレットを追加」をクリック
4. キー名と値を入力して保存

サーバーコードでの使用

// 環境変数として自動的に注入されます
const notionApiKey = process.env.NOTION_API_KEY;
const databaseUrl = process.env.DATABASE_URL;

// APIクライアントの初期化
const notion = new Client({ auth: notionApiKey });

セキュリティに関する注意

• シークレットはAES-256で暗号化して保存されます
• 一度保存したシークレットの値は表示されません（上書きのみ可能）
• コード内にAPIキーをハードコードしないでください

アクセス制御

MCPサーバーへのアクセスをAPIキーで制御できます。ツール単位での権限設定も可能です。

APIキーの発行

1. ダッシュボードの「API Keys」を開く
2. 「新規APIキー」をクリック
3. キー名を入力して作成
4. 表示されたAPIキーを安全な場所に保存（一度しか表示されません）

認証方法

MCPクライアントからの接続時に、APIキーをヘッダーに含めます。

Authorization: Bearer your-api-key-here

チーム管理

ワークスペースにチームメンバーを招待して、サーバーを共同で管理できます。

ロール（役割）

メンバーの招待

1. ダッシュボードの「チーム」ページを開く
2. 「メンバーを追加」をクリック
3. 招待するユーザーのメールアドレスを入力
4. ロールを選択して招待を送信

メンバー数の制限

プランによってワークスペースに追加できるメンバー数が異なります。 詳細は料金プランをご確認ください。

ログ・監視

ログの種類

メトリクス

• リクエスト数（時間別・日別）
• 平均レスポンス時間
• エラー率
• 稼働率（Uptime）

AIクライアントとの接続

デプロイしたMCPサーバーを各種AIクライアントから利用する方法を説明します。

Claude Desktop

Claude Desktopの設定ファイルにMCPサーバーを追加します。

{
  "mcpServers": {
    "my-server": {
      "url": "https://your-server.nodeflare.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

Cursor

Cursorの設定でMCPサーバーのURLを追加します。

{
  "servers": {
    "my-server": {
      "url": "https://your-server.nodeflare.dev/mcp",
      "apiKey": "your-api-key"
    }
  }
}

エンドポイントURL

サーバーのエンドポイントURLは、ダッシュボードのサーバー詳細ページで確認できます。
形式: https://[slug].nodeflare.dev/mcp

料金プラン

用途に応じた柔軟なプランをご用意しています。

プラン比較

プランの変更

ダッシュボードの「課金」ページからいつでもプランを変更できます。 アップグレードは即座に反映され、ダウングレードは次回請求サイクルから適用されます。

支払い方法

クレジットカード（Visa、Mastercard、American Express、JCB）に対応しています。 請求は月次または年次で選択可能です。年払いの場合は2ヶ月分お得になります。

APIリファレンス

NodeFlareの管理APIを使用して、プログラムからサーバーを管理できます。 APIキーによる認証が必要です。

ベースURL

https://api.nodeflare.dev/api/v1

認証

すべてのAPIリクエストには認証が必要です。Cookieベースのセッション認証、 またはAPIキーによるBearer認証が利用可能です。

Authorization: Bearer your-api-key

主要エンドポイント

ワークスペース

サーバー

シークレット・ログ

チームメンバー

トラブルシューティング