Windsurf

MCP 経由で AstroWay API を Windsurf に接続します。サーバーは Cascade アシスタントが利用します。

前提条件

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

接続

~/.codeium/windsurf/mcp_config.json を編集します。Settings → Cascade → MCP からも設定できます。注意: リモートサーバーの場合、Windsurf は url ではなく serverUrl キーを使います。以下のいずれかのブロックを貼り付け、Windsurf を再起動してください。

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

{
"mcpServers": {
  "astroway": {
    "serverUrl": "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" }
  }
}
}

動作確認

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

トラブルシューティング

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

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

参考になりましたか？

編集を提案

最終更新日: 2026/09/25