Cursor

MCP 経由で AstroWay API を Cursor に接続します。ホスト型 (HTTP) とローカルの stdio パッケージ、どちらのトランスポートも利用できます。

前提条件

ダッシュボードで API キーを取得してください。無料でテストする場合は sandbox キー aw_test_* を使用してください。このキーではクレジットが消費されません。

接続

~/.cursor/mcp.json (またはプロジェクト単位の .cursor/mcp.json) を編集します。Settings → MCP からも設定できます。以下のいずれかのブロックを貼り付け、Cursor を再起動してください。

Hosted (HTTP): インストール不要で、Bearer トークンで認証します:

{
"mcpServers": {
  "astroway": {
    "url": "https://mcp.astroway.info/mcp",
    "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Stdio (npx): ローカルのサブプロセスとして動作し、環境変数で認証し、オフラインでも動作します:

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "@astroway/mcp"],
    "env": { "ASTROWAY_API_KEY": "aw_live_YOUR_KEY" }
  }
}
}

動作確認

チャットでエージェントに “Astroway のツールを一覧表示して” と送るか、無料の reference ツール (たとえば星座の一覧取得) を呼び出すよう依頼してください。結果が返ってくれば、接続は正常です。

トラブルシューティング

401 / invalid key: キーのプレフィックスが aw_live_* または aw_test_* であり、失効していないことを確認してください。ダッシュボードで確認できます。
ツールが表示されない: Cursor を完全に再起動し、~/.cursor/mcp.json のパスを確認してください (プロジェクト単位の場合は .cursor/mcp.json)。
バリデーションエラー -32602 (stdio の場合): パッケージを更新してください: npm i @astroway/mcp@latest。スキーマは最新の仕様から再生成されます。

すべてのクライアント: エージェント設定。

参考になりましたか？

編集を提案

最終更新日: 2026/09/25