チューリップMCPのセットアップ

  • 公開日 Aug 7, 2025
  • 1 分で読めます
  • Pete Hartnett
 Prev Next

チューリップMCPのセットアップ方法を教えてください。

Tulip MCPの詳細なセットアップ・ドキュメントは、公式リポジトリ（https://github.com/tulip/tulip-mcp/tree/master）で入手できます。

チューリップMCPのセットアップは合理化されています。新しいプロセスには、3つの重要なステップがあります：

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

前提条件

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

npmとNode.jsのバージョンを確認するターミナル/Windowsターミナル（コマンドプロンプト、PowerShell）で以下のコマンドを実行します：

node -vnpm -vバージョン名が表示されれば、問題ありません。

Tulip API認証情報の設定

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

1.設定フォルダの作成

環境設定ファイルを保存するフォルダを選択または作成します。

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

このファイルはTulipの認証情報を保存します。.envファイルのサンプルはこちらです。

Macユーザーの方

  1. ターミナルを開き、以下のコマンドを実行します：

bashtouch .envnano .env2.3.認証情報を追加したら、以下の保存手順に従ってください。

Windows ユーザー：

  1. メモ帳を開く。
  2. クレデンシャル・テンプレート（次のステップ）を新しいファイルに貼り付ける。
  3. 認証情報を追加したら、以下の保存手順に従ってください。

2.Tulip認証情報の追加

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

TULIP_API_KEY=your_api_key_hereTULIP_API_SECRET=your_api_secret_hereTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=your_workspace_id_here_if_using_account_api_key

  • tulip_base_url：チューリップにアクセスするためのURLです。
    例 ：https://my-company.tulip.co
  • TULIP_WORKSPACE_ID: Tulip URLの/w/の後にあります。
    例 https://my-company.tulip.co/w/DEFAULT、ワークスペースIDはDEFAULTです。

:::(警告) (重要)アカウントAPIキー(アカウント設定から)を使用している場合のみ、TULIP_WORKSPACE_IDを含めます。

ワークスペース API キー(ワークスペース設定から) を使用している場合は、このfield を空白のままにできます。
:::
ファイルを保存し、指定したフォルダにファイルがあることを確認します。

3.サーバーの実行

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

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

bashnpx @tulip/mcp-serverこのコマンドにより、最新バージョンのTulip MCPサーバーがダウンロードされ、起動します。これでサーバーが起動し、MCPクライアントに接続できるようになります。

4.Tulip MCPへの接続

MCPクライアントがサーバーを実行するとき、.envファイルと同じディレクトリにない可能性があります。この問題を解決するには、クライアントの設定で--envフラグを使用して、.envファイルへのフルパスを提供する必要があります。

ガイド.env ファイルのパスを見つける

  1. .envファイルを作成したフォルダに移動します。
  2. Windowsの場合 Shiftキーを押しながら.envファイルを右クリックし、"Copy as path "を選択します。
  3. macOSの場合 .envファイルを右クリックし、Optionキーを押しながら**"Copy .env as Pathname "**を選択します。
  4. このコピーしたパスを以下のクライアント設定で使用します。

ガイドクロードデスクトップ

  1. Claude Desktop メニューバーからSettings...>Developer>Edit Config を選択します。
  2. claude_desktop_config.jsonファイルが開きます。
  3. mcpServersオブジェクト内にサーバー構成を追加します。 "C:∕"をコピーした実際のパスに置き換える必要がある ：{ "tulip-mcp"：{ "command"："npx", "args"：[ "@tulip/mcp-server", "--env", "C:∕Pathtoyour∕env" ]。 } } }
  4. ファイルを保存し、Claude Desktopを再起動する。

詳細については、公式のClaude Desktop MCP Quickstartを参照してください。

カーソル

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

Cursor に接続する

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

高度な設定

Tulip API認証情報の取得

API認証情報（トークン）は、Tulip instance の設定から作成できます。

  1. ログインします： Tulip instance にアクセスします。
  2. APIトークンに移動します：設定」>「APIトークン」に移動します。
  3. **新しい API トークンを作成します：**新しいトークンを生成し、わかりやすい名前を付けます（例：「MCP Server」）。
  4. **スコープを設定します：**トークンに必要な権限（スコープ）を付与する。基本的なアクセスに適したスコープとしては、station:read、users:read、tables:read、machines:read、apps:read、urls:signがあります。
  5. **クレデンシャルをコピーする：**生成されたAPI KeyとSecretをコピーし、.envファイルに貼り付ける。

ツール選択の設定

デフォルトでは、安全のため、サーバーは読み取り専用ツールとテーブルツールだけを有効にします。.envファイルのENABLED_TOOLS環境変数を使用して、利用可能なツールをカスタマイズできます。

ENABLED_TOOLS変数は、カンマで区切られたリストを受け付けます：

  • 個々のツール名： listStationsのような特定のツール。
  • **カテゴリー：**セキュリティ・ベースのグループ化（読み取り専用、書き込み、管理者）。
  • **タイプ：**リソースベースのグループ化（テーブル、マシン、ユーザー、アプリ、インターフェイス、ステーション、ステーショングループ、ユーティリティ）。

例

例: ``env

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

ENABLED_TOOLS=read-only,write

# テーブルとステーションに関連する全てのツールを有効にする

ENABLED_TOOLS=テーブル,ステーション

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

ENABLED_TOOLS=listStation,addRecord

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

ENABLED_TOOLS=read-only,interface,station,user

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

ENABLED_TOOLS=read-only,write,admin``を有効にする。

関連記事