Tulip MCPの設定

Tulip MCPの設定方法は？

Tulip MCPの詳細なセットアップ手順は、公式リポジトリで確認できます：https://github.com/tulip/tulip-mcp/tree/master

Tulip MCPの設定は簡素化されました。新しいプロセスには、以下の3つの主要なステップが含まれます：

認証情報の設定
サーバーの実行
MCPクライアントへの接続

前提条件

開始する前に、お使いのシステムにNode.js がインストールされていることを確認してください。これはサーバーを実行するために必要です。

npm および Node.js のバージョンを確認するターミナルまたは Windows ターミナル（コマンドプロンプト、PowerShell）で、次のコマンドを実行してください：

node -vnpm -vバージョン名が表示されれば準備は完了です。ステップ1に進んでください。表示されない場合は、node.jsの公式サイトにアクセスし、お使いのOSに対応した最新バージョンをインストールしてください。

Tulip API 認証情報の設定

API 経由で Tulip に接続するには、API 認証情報を安全に保存する.envファイルを作成する必要があります。

1. 設定フォルダを作成する

環境設定ファイルを保存するフォルダを選択するか、新規に作成してください。

ガイド：`.env`ファイルの作成

このファイルには、Tulipの認証情報が保存されます。.envファイルのサンプルはこちらでご覧いただけます。

Macユーザーの場合：

ターミナルを開き、以下のコマンドを実行してください：

bashtouch .envnano .env2. 次の手順で説明する認証情報のテンプレートを、新しいファイルに貼り付けてください。3. 認証情報を追加したら、以下の保存手順に従ってください。

Windows ユーザー：

メモ帳を開きます。
（次の手順にある）認証情報のテンプレートを新しいファイルに貼り付けてください。
認証情報を追加したら、以下の保存手順に従ってください。

2. Tulipの認証情報を追加する

以下の内容を.envファイルにコピーして貼り付け、プレースホルダーの値を実際の認証情報に置き換えてください：

TULIP_API_KEY=ここにAPIキーを入力TULIP_API_SECRET=ここにAPIシークレットを入力TULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=アカウントAPIキーを使用している場合はここにワークスペースIDを入力

TULIP_BASE_URL: これは、Tulipにアクセスするために使用するURLです。
例:https://my-company.tulip.co
TULIP_WORKSPACE_ID: Tulip の URL の/w/ の後に記載されています。
例:https://my-company.tulip.co/w/DEFAULT の場合、ワークスペース ID はDEFAULT です。

:::(警告) (重要)
TULIP_WORKSPACE_ID は、アカウント API キー（アカウント設定から取得）を使用している場合のみ指定してください。

ワークスペース API キー（ワークスペース設定から取得）を使用している場合は、このfield を空白のままにしておいてください。
:::
ファイルを保存し、指定したフォルダにファイルが配置されていることを確認してください。

3. サーバーを実行する

.envファイルの設定が完了したら、サーバーを起動できます。

ターミナルまたはコマンドプロンプトを開き、.envファイルが含まれているフォルダに移動して、次のコマンドを実行してください：

bashnpx @tulip/mcp-serverこのコマンドにより、Tulip MCP サーバーの最新バージョンがダウンロードされ、起動します。これでサーバーが稼働し、MCP クライアントへの接続準備が整いました。

4. Tulip MCPへの接続

MCPクライアントがサーバーを実行する際、.envファイルと同じディレクトリにない場合があり、その場合は認証情報が自動的に検出されません。これを解決するには、クライアントの設定で--envフラグを使用して、.envファイルへのフルパスを指定する必要があります。

ガイド：.env ファイルのパスの確認方法

.envファイルを作成したフォルダに移動します。
Windowsの場合： Shiftキーを押しながら.envファイルを右クリックし、**「パス名としてコピー」**を選択します。
macOSの場合： .envファイルを右クリックし、Optionキーを押したまま、**「.envをパス名としてコピー」**を選択します。
このコピーしたパスは、以下のクライアント設定で使用します。

ガイド：Claude Desktop

Claude Desktop のメニューバーから、[設定...]>[開発者] > [設定の編集] を選択します。
これにより、claude_desktop_config.jsonファイルが開きます。
mcpServersオブジェクト内にサーバー設定を追加します。 「C:\\path\\to\\your\\.env」を、実際にコピーしたパスに置き換える必要があります。 json { "mcpServers": { "tulip-mcp": { "command": "npx", "args": [ "@tulip/mcp-server", "--env", "C:\\path\\to\\your\\.env" ] } } }
ファイルを保存し、Claude Desktopを再起動してください。

詳細については、Claude Desktop MCP の公式クイックスタートを参照してください。

Cursor

最も簡単なセットアップを行うには、下のボタンをクリックしてください。これにより、Cursor にコマンドが事前に入力されます。

Cursor に接続

ボタンをクリックした後、プレースホルダーのテキスト（REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE）を、先ほどコピーした.envファイルへのフルパスに置き換える必要があります。

詳細設定

Tulip API 認証情報の取得

API 認証情報（サービスアカウント）は、Tulip instance の設定から作成できます。

ログイン： Tulip instance にアクセスしてください。
Tulip API へ移動: [設定] > [Tulip API] に移動します。
**新しいサービスアカウントの作成：**新しいサービスアカウントを生成し、わかりやすい名前（例：「MCP サーバー」）を付けます。
**スコープの設定：**サービスアカウントに必要な権限（スコープ）を付与します。基本的なアクセスを行うための適切な初期スコープのセットは以下の通りです： stations:read, users:read, tables:read, machines:read, apps:read, urls:sign
**認証情報をコピー：**生成された API キーとシークレットをコピーし、.envファイルに貼り付けます。

ツールの選択設定

デフォルトでは、安全上の理由から、サーバーは読み取り専用およびテーブル関連のツールのみを有効にしています。.envファイル内のENABLED_TOOLS環境変数を使用して、利用可能なツールをカスタマイズできます。

ENABLED_TOOLS変数には、カンマ区切りのリストを指定できます。指定可能な項目は以下の通りです：

個別のツール名： listStations などの特定のツール。
**カテゴリ：**セキュリティに基づくグループ分け（読み取り専用、書き込み、管理者）。
**タイプ：**リソースに基づくグループ分け（table、machine、user、app、interface、station、station-group、utility）。

例：


# すべての読み取りおよび書き込み操作を有効にする

ENABLED\_TOOLS=read-only,write

# テーブルおよびステーションに関連するすべてのツールを有効にする

ENABLED\_TOOLS=table,station

# 特定のツールを有効にする

ENABLED\_TOOLS=listStations,addRecord

# 推奨される混合アプローチ

ENABLED\_TOOLS=read-only,interface,station,user

# すべてを有効にする（データの削除やアーカイブが可能になるため、使用には注意が必要です）

ENABLED\_TOOLS=read-only,write,admin```

**関連記事**

* [Tulip API の設定](/r230/docs/set-up-a-tulip-api)

Tulip MCPの設定