Claude Desktop

Berikut adalah terjemahan MDX BODY dari Ukraina ke Indonesia:

import { Code } from '@astrojs/starlight/components';

Hubungkan API AstroWay ke **Claude Desktop** melalui MCP. Kedua transportasi tersedia: hosted (HTTP) dan lokal stdio-paket.

## Syarat-Syarat

Dapatkan API kunci di [dashboard](https://api.astroway.info/dashboard/sign-up). Untuk pengujian gratis, gunakan kunci sandbox `aw_test_*` - tidak akan menguras kredit.

## Penghubungan

Buka Pengaturan → Pengembang → Edit Konfigurasi - Claude Desktop akan menampilkan jalan ke file `claude_desktop_config.json`. Masukkan salah satu blok di bawah dan **reboot** Claude Desktop.

**Hosted (HTTP)**: tidak perlu diinstal, autentikasi melalui Bearer-token:

<Code lang="json" title="claude_desktop_config.json" code={`{
  "mcpServers": {
    "astroway": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
    }
  }
}`} />

**Stdio (npx)**: proses lokal, autentikasi melalui variabel lingkungan, berjalan offline:

<Code lang="json" title="claude_desktop_config.json" code={`{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_YOUR_KEY" }
    }
  }
}`} />

## Pengecekan

Tulis Claude di chat: «Daftar instrumen Astroway» - atau minta instrumen referensi gratis, seperti mendapatkan daftar tanda zodiak. Jika hasilnya datang, penghubungan berjalan.

## Mengatasi Masalah

- **401 / kunci tidak valid**: pastikan kunci memiliki awalan `aw_live_*` atau `aw_test_*` dan tidak telah dicabut. Periksa di [dashboard](https://api.astroway.info/dashboard/sign-up).
- **Instrumen tidak muncul**: reboot Claude Desktop (keluar, bukan hanya menutup jendela) dan periksa jalan ke `claude_desktop_config.json`.
- **Kesalahan validasi `-32602`** (untuk stdio): perbarui paket: `npm i @astroway/mcp@latest`. Schemas akan diregenerasi dengan spesifikasi terkini.

Semua klien - [Pengaturan Agent](/agent-setup/).