aaro-erp-mcp-server

AaroYazilim/aaro-erp-mcp-server

3.2

If you are the rightful owner of aaro-erp-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Claude MCP Server is a model context protocol server designed to facilitate communication and integration between various systems and applications using the Model Context Protocol (MCP).

AARO ERP MCP Server

TypeScript Node.js MCP

AARO ERP sistemi için Claude Desktop entegrasyonu sağlayan MCP (Model Context Protocol) server'ı. Bu server, AARO ERP API'sine erişim, token yönetimi ve tüm temel ERP işlemlerini Claude Desktop üzerinden gerçekleştirmenizi sağlar.

📋 Mevcut Araçlar Listesi

Araç AdıAçıklamaKategori
erp_token_alToken alma ve cache yönetimi🔐 Token
erp_token_silToken cache silme🔐 Token
erp_stok_listeleStok listesi ve filtreleme📊 Stok
erp_stok_olusturYeni stok kartı oluşturma📊 Stok
erp_stok_hareketleri_listeleStok hareketleri📊 Stok
erp_seri_lot_listeleSeri/Lot takibi📊 Stok
erp_barkod_listeleBarkod yönetimi📊 Stok
erp_cari_listeleCari hesap listeleme👥 Cari
erp_cari_olusturYeni cari hesap oluşturma👥 Cari
erp_siparis_listeleSipariş hareketleri📋 Sipariş
erp_fatura_listeleFatura hareketleri📋 Fatura
erp_depo_listeleDepo yönetimi🏢 Operasyon
erp_doviz_listeleDöviz kurları🏢 Operasyon
erp_kasa_listeleKasa hareketleri🏢 Operasyon
erp_banka_listeleBanka hesapları🏢 Operasyon
erp_personel_listelePersonel bilgileri🏢 Operasyon
erp_dekont_listeleMuhasebe dekontları🏢 Operasyon
erp_api_cagirGenel API çağrısı🔧 Genel

Toplam: 18 araç

🚀 Hızlı Başlangıç

Ön Gereksinimler

📦 Kurulum

Kurulum gerekmez! NPX ile doğrudan kullanabilirsiniz. Paket otomatik olarak indirilir ve çalıştırılır.

⚙️ Claude Desktop Konfigürasyonu

Claude Desktop'ın MCP ayarları dosyasını düzenleyin:

Windows:

%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

macOS:

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Linux:

~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Aşağıdaki konfigürasyonu ekleyin:

{
  "mcpServers": {
    "aaro-erp": {
      "command": "npx",
      "args": ["aaro-erp-mcp-server"],
      "disabled": false
    }
  }
}

🔄 Claude Desktop'ı Yeniden Başlatın

Konfigürasyon değişikliklerinin etkili olması için Claude Desktop'ı kapatıp yeniden açın.

✅ Kurulum Tamamlandı!

Artık Claude Desktop'ta AARO ERP araçlarını kullanabilirsiniz. İlk kullanımda paket otomatik olarak NPM'den indirilecektir.

🔍 Filtreleme Özellikleri

Tüm listeleme araçları gelişmiş filtreleme destekler:

Filtreleme Örnekleri:

  • StokID="100,101,102" (çoklu seçim)
  • TipID="!105001" (hariç tutma)
  • TarihBas="2024-01-01" (tarih aralığı)
  • Sayfa=2, SayfaSatirSayisi=50 (sayfalama)
  • EsnekAramaKisiti="arama_terimi" (genel arama)

📊 Tip ID'leri

Stok Tipleri

  • 105001 - Fiziksel Stok
  • 105002 - Gelir-Gider
  • 105003 - Demirbaş

Cari Tipleri

  • 2001 - Standart Cari

Hareket Tipleri

  • 10005 - Satış Faturası
  • 10006 - Alış Faturası
  • 10009 - Satış İrsaliyesi
  • 10013 - Alınan Sipariş
  • 10019 - Depolar Arası Transfer

🔐 Güvenlik

  • Bearer token authentication
  • HTTPS bağlantıları
  • Kapsamlı hata yakalama ve raporlama
  • Tarayıcı otomasyonu güvenlik önlemleri

🛠️ Teknik Detaylar

  • TypeScript ile tip güvenliği
  • Puppeteer ile tarayıcı otomasyonu
  • Axios ile HTTP istekleri
  • MCP SDK ile Claude Desktop entegrasyonu
  • Modüler yapı ile kolay genişletme

📝 API Endpoint'leri

  • Base URL: https://erp.aaro.com.tr/api
  • Token URL: https://erp.aaro.com.tr/Account/GeciciErisimAnahtari

🐛 Hata Ayıklama

Server logları Claude Desktop'ın developer console'unda görüntülenir. Manuel test için:

npx aaro-erp-mcp-server

🔧 Geliştirme

NPM Paketi Bilgileri

  • Paket Adı: aaro-erp-mcp-server
  • Platform Desteği: Windows, macOS, Linux
  • Node.js Gereksinimi: v18+
  • Otomatik Güncellemeler: NPX her çalıştırmada en son sürümü kullanır

Katkıda Bulunma

  1. Bu repository'yi fork edin
  2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
  3. Değişikliklerinizi commit edin (git commit -m 'Add some amazing feature')
  4. Branch'inizi push edin (git push origin feature/amazing-feature)
  5. Pull Request oluşturun

Test Etme

Server'ın çalışıp çalışmadığını test etmek için:

# Server'ı manuel olarak başlatın
npx aaro-erp-mcp-server

# Başarılı çıktı:
# [2025-07-21T06:59:59.000Z] [INFO] Konfigürasyon dosyaları başarıyla yüklendi
# [2025-07-21T06:59:59.000Z] [INFO] ERP Token MCP server stdio üzerinde çalışıyor

🚨 Sorun Giderme

Yaygın Sorunlar

1. "Server disconnected" hatası:

  • Node.js versiyonunun v18+ olduğundan emin olun
  • İnternet bağlantınızı kontrol edin
  • Claude Desktop'ı yeniden başlatın

2. "Package not found" hatası:

  • NPM'in düzgün kurulu olduğundan emin olun
  • npm cache clean --force komutunu çalıştırın
  • Tekrar deneyin

3. Token alınamıyor:

  • AARO ERP hesabınızın aktif olduğundan emin olun
  • İnternet bağlantınızı kontrol edin
  • Tarayıcı popup'larının engellenip engellenmediğini kontrol edin

4. MCP server görünmüyor:

  • Konfigürasyon dosyasının doğru konumda olduğundan emin olun
  • JSON formatının geçerli olduğunu kontrol edin
  • npx aaro-erp-mcp-server komutunun çalıştığından emin olun

Manuel Test

Paketi manuel olarak test etmek için:

# Paketi çalıştır
npx aaro-erp-mcp-server

# Başka bir terminalde test
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | npx aaro-erp-mcp-server

Cache Temizleme

NPX cache'ini temizlemek için:

# NPX cache temizle
npm cache clean --force

# Belirli paketi temizle
npx clear-npx-cache aaro-erp-mcp-server

🔄 Sürüm Geçmişi

v1.0.0 (2025-01-18)

  • ✅ İlk stabil sürüm
  • ✅ 17 temel ERP aracı
  • ✅ Token cache sistemi
  • ✅ Otomatik token yönetimi
  • ✅ Kapsamlı hata yönetimi
  • ✅ TypeScript desteği

📄 Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için dosyasına bakın.

🙏 Teşekkürler

📞 Destek ve İletişim