メインコンテンツへスキップ
このガイドでは、Cursorでemma MCP Serverをセットアップする手順を説明します。

​
前提条件

始める前に、以下を確認してください：
  • Cursorがインストールされていること
  • APIアクセス権のあるemmaアカウント
  • emma API Key（Settingsで取得可能）

​
設定

​
ステップ1: API Keyを取得

  1. emmaにログイン
  2. Settingsに移動
  3. API Keyをコピー

​
ステップ2: Cursorを設定

Cursorの設定ファイルにemma MCPサーバーを追加します。
~/.cursor/mcp.jsonを編集：
{
  "mcpServers": {
    "emma": {
      "command": "python",
      "args": ["-m", "emma_mcp"],
      "env": {
        "EMMA_API_KEY": "your_api_key_here"
      }
    }
  }
}
your_api_key_hereを実際のemma API Keyに置き換えてください。API Keyをバージョン管理にコミットしないでください。

​
ステップ3: Cursorを再起動

設定ファイルを保存したら、Cursorを再起動してMCPサーバーを読み込みます。

​
接続の確認

emma MCP Serverが正しく動作しているか確認するには、ヘルスチェックツールを使用します：
  1. Cursorを開く
  2. AIチャットで「emmaの接続状態を確認して」と入力
  3. emma_health_checkツールが成功レスポンスを返すはずです

​
設定オプション

​
環境変数

変数必須説明
EMMA_API_KEY必須emma API Key

​
トラブルシューティング

​
サーバーが起動しない

PythonがインストールされていてPATHに含まれていることを確認してください。以下のコマンドで確認できます：
python --version
Pythonが見つからない場合は、python.orgからインストールしてください。
emma MCPパッケージが正しくインストールされていることを確認してください。インストールについてサポートが必要な場合はお問い合わせください。
API Keyが正しく、有効期限が切れていないことを確認してください。emmaのSettingsから新しいキーを生成できます。

​
接続の問題

  1. インターネット接続を確認
  2. API Keyが有効であることを確認
  3. ファイアウォールルールが接続をブロックしていないことを確認
  1. Cursorを完全に再起動
  2. MCP設定ファイルの構文エラーを確認
  3. サーバー名が正確に一致していることを確認：emma

​
セキュリティのベストプラクティス

1

環境変数を使用

API Keyをハードコードする代わりに、環境変数の使用を検討してください：
{
  "mcpServers": {
    "emma": {
      "command": "python",
      "args": ["-m", "emma_mcp"],
      "env": {
        "EMMA_API_KEY": "${EMMA_API_KEY}"
      }
    }
  }
}
その後、シェルプロファイルで環境変数を設定します。
2

API Key権限を制限

emmaがスコープ付きAPI Keyをサポートしている場合、必要な権限のみを持つキーを使用してください。
3

定期的にキーをローテーション

定期的に新しいAPI Keyを生成し、古いものを無効にしてください。

​
次のステップ

emma MCP Server

利用可能なツールとユースケースについて学ぶ

ツールリファレンス

全ツールの詳細ドキュメント