# MCP · blockwallets'ı yapay zekâ araçlarınızdan kullanın

> blockwallets uzak MCP sunucusu: entegrasyon dokümanlarında arayın, test faturası oluşturun, siparişleri ve bakiyeyi Claude, ChatGPT, Cursor ve Codex içinden kontrol edin. Hiçbir araç para çıkaramaz.

Claude, ChatGPT, Cursor ve Codex sizin yerinize dokümanları okusun, test faturası oluştursun ve siparişleri kontrol etsin. Yalnızca ödeme alabilir ve veri okuyabilir. Para çıkaramaz.

## İki adres

- `https://blockwallets.io/mcp` (Giriş gerekir): OAuth ile giriş ya da panelden alınan bir MCP token'ı (Bearer). Tüm araçlar.
- `https://blockwallets.io/mcp/public` (Girişsiz): Yalnızca herkese açık araçlar: dokümanlar, ağlar, fiyatlar, imza açıklaması, entegrasyon listesi.

## Kısacası: entegre edin, hata ayıklayın ve hesaplarınızı yapay zekâdan izleyin.

- Siz entegrasyonu yazarken yapay zekâ dokümanlarımızı ve imza kurallarını doğrudan okur; kopyala-yapıştır gerekmez.
- Test token'ıyla yapay zekâ bir test faturası oluşturur, siz ödemeyi simüle edersiniz, o da durumu baştan sona kontrol eder.
- Günlük işlerde “dün ne kadar tahsil ettik?” ya da “order_1042 ödendi mi?” diye sorun, yanıtı alın.

## Bir parçayı kopyalayıp aracınıza yapıştırın.

Token'ları panelde “Geliştiriciler › Yapay zekâ araçları (MCP)” bölümünde oluşturun; token yalnızca bir kez gösterilir. Bir test token'ıyla başlayın.

### Claude Code

Token ile; ya da --header'ı kaldırıp Claude Code içinde /mcp çalıştırarak OAuth ile giriş yapın.

```bash
claude mcp add --transport http blockwallets https://blockwallets.io/mcp \
  --header "Authorization: Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

### Claude Code · yalnızca doküman araçları (girişsiz)

```bash
claude mcp add --transport http blockwallets-docs https://blockwallets.io/mcp/public
```

### Cursor · ~/.cursor/mcp.json

```json
{
  "mcpServers": {
    "blockwallets": {
      "url": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

### Windsurf · ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "blockwallets": {
      "serverUrl": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

### Codex · ~/.codex/config.toml

Token'ı BLOCKWALLETS_MCP_TOKEN ortam değişkenine koyun; HTTP MCP desteği olan güncel bir Codex gerekir.

```toml
[mcp_servers.blockwallets]
url = "https://blockwallets.io/mcp"
bearer_token_env_var = "BLOCKWALLETS_MCP_TOKEN"
```

## Claude ve ChatGPT: yalnızca giriş yapın.

### Claude (web / masaüstü)

1. Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle
2. Adı blockwallets olsun, URL olarak https://blockwallets.io/mcp kullanın
3. Bağlan'a tıklayın ve açılan sayfada blockwallets panelinize giriş yapın
4. Onay sayfasında test veya canlı modu ve fatura oluşturmaya izin verilip verilmeyeceğini seçip İzin ver'e tıklayın

### ChatGPT

1. Ayarlar → Uygulamalar ve bağlayıcılar → Gelişmiş, Geliştirici modunu açın
2. https://blockwallets.io/mcp URL'si ve OAuth kimlik doğrulamasıyla bir bağlayıcı oluşturun
3. blockwallets panelinize giriş yapın
4. Onay sayfasında modu ve izinleri seçip İzin ver'e tıklayın

Giriş yapmak istemiyor musunuz? Yalnızca herkese açık doküman araçları için https://blockwallets.io/mcp/public adresini kullanın.

## 11 araç, hiçbiri para çıkaramaz.

| Araç | Ne yapar | İzin |
|---|---|---|
| `search_docs` | Entegrasyon dokümanlarında arar; ilgili bölümleri ve bağlantıları döndürür | herkese açık |
| `get_doc` | Bir doküman bölümünü Markdown olarak okur | herkese açık |
| `list_networks` | Coin'ler ve ağlar, onay sayıları, asgari tutarlar | herkese açık |
| `get_pricing` | Ücretler ve hacim kademeleri | herkese açık |
| `explain_signature` | İmzanın nasıl hesaplandığını adım adım gösterir (asla API key istemez) | herkese açık |
| `integration_checklist` | Teknolojinize göre entegrasyon adımları ve kabul listesi | herkese açık |
| `create_payment` | Bir fatura oluşturur ve ödeme sayfasını döndürür (order_id'ye göre idempotent) | payments:create |
| `create_payment_link` | Ödeme bağlantısı ve QR kod oluşturur | payments:create |
| `get_payment` | order_id veya uuid ile bir faturayı okur | read |
| `list_payments` | Faturaları duruma ve tarihe göre listeler | read |
| `get_balance` | Canlı bakiyeyi okur (yalnızca okuma, çekim yok) | read |

## Yalnızca alır. Asla göndermez.

- **Hiçbir araç para çıkarmaz**: Para çekme, ödeme gönderme, iade, çekim adresleri, callback URL'leri ve anahtarlar MCP'de yoktur, izinleri de yoktur. Bunları yalnızca siz panelden yapabilirsiniz.
- **Test modunda başlayın**: Test kimlik bilgileri yalnızca testnet'te fatura oluşturur ve yalnızca test verilerini görür. Gerçek para yok.
- **Canlıyı salt okunur tutun**: Canlı kimlik bilgileri gerçek siparişleri ve bakiyeleri görür. Fatura oluşturmanız gerekmedikçe yalnızca okuma izni verin. İki adımlı doğrulaması açık hesaplar canlı kimlik bilgisi için kod girer ve her seferinde size e-posta göndeririz.
- **İstediğiniz an iptal edin**: Token'lar ve OAuth yetkileri paneldeki aynı listededir. Birini iptal edin, token'ları anında çalışmayı durdurur.
- **Yalnızca hash**: Token'lar ve kodlar sha256 olarak saklanır; token yalnızca bir kez gösterilir. Her satıcı çağrısı denetim kaydına yazılır ve her kimlik bilgisi dakikada en fazla 60 istekle sınırlıdır.

## SSS

### MCP nedir?

Model Context Protocol, yapay zekâ araçlarının dış hizmetleri çağırması için açık bir standarttır. Bağlandıktan sonra Claude, ChatGPT, Cursor ve diğerleri blockwallets araçlarını doğrudan çağırabilir.

### Bir yapay zekâ bununla paramı alabilir mi?

Hayır. Para çekme, ödeme gönderme, iade ya da adres veya anahtar değiştirme aracı yoktur; bunlar için bir izin de bulunmaz.

### Test ile canlı arasındaki fark nedir?

Test modu, test faturaları ve verileriyle herkese açık testnet'lerde çalışır; canlı, gerçek hesabınızdır. Akışı önce test modunda çalıştırın.

### Cursor OAuth ile girişi destekliyor mu?

Şimdilik Cursor'da panelden alınan bir token kullanın. OAuth; Claude, ChatGPT ve Claude Code gibi https veya loopback yönlendirmesi kullanan istemcilerle çalışır.

### Erişimi nasıl iptal ederim?

Token'ı veya yetkiyi panelde “Geliştiriciler › Yapay zekâ araçları (MCP)” bölümünde bulup iptal edin; anında geçerli olur.

OAuth metadata: https://blockwallets.io/.well-known/oauth-protected-resource · https://blockwallets.io/.well-known/oauth-authorization-server