Used for making HTTP requests to the AARO ERP API, enabling token management, data retrieval, and all ERP operations through the integration.
Powers the MCP server that connects Claude Desktop to AARO ERP, providing a runtime environment for the integration capabilities.
Enables browser automation for interacting with AARO ERP system, particularly for token management and web interface operations.
Provides type safety for the MCP server implementation, ensuring reliable integration between Claude Desktop and AARO ERP.
AARO ERP MCP Server
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çıklama | Kategori |
---|---|---|
erp_token_al | Token alma ve cache yönetimi | 🔐 Token |
erp_token_sil | Token cache silme | 🔐 Token |
erp_stok_listele | Stok listesi ve filtreleme | 📊 Stok |
erp_stok_olustur | Yeni stok kartı oluşturma | 📊 Stok |
erp_stok_hareketleri_listele | Stok hareketleri | 📊 Stok |
erp_seri_lot_listele | Seri/Lot takibi | 📊 Stok |
erp_barkod_listele | Barkod yönetimi | 📊 Stok |
erp_cari_listele | Cari hesap listeleme | 👥 Cari |
erp_cari_olustur | Yeni cari hesap oluşturma | 👥 Cari |
erp_siparis_listele | Sipariş hareketleri | 📋 Sipariş |
erp_fatura_listele | Fatura hareketleri | 📋 Fatura |
erp_depo_listele | Depo yönetimi | 🏢 Operasyon |
erp_doviz_listele | Döviz kurları | 🏢 Operasyon |
erp_kasa_listele | Kasa hareketleri | 🏢 Operasyon |
erp_banka_listele | Banka hesapları | 🏢 Operasyon |
erp_personel_listele | Personel bilgileri | 🏢 Operasyon |
erp_dekont_listele | Muhasebe dekontları | 🏢 Operasyon |
erp_api_cagir | Genel API çağrısı | 🔧 Genel |
Toplam: 18 araç
🚀 Hızlı Başlangıç
Ön Gereksinimler
- Node.js (v18 veya üzeri)
- Claude Desktop uygulaması
- AARO ERP hesabı ve erişim yetkisi
📦 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:
macOS:
Linux:
Aşağıdaki konfigürasyonu ekleyin:
🔄 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:
🔧 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
- Bu repository'yi fork edin
- Feature branch oluşturun (
git checkout -b feature/amazing-feature
) - Değişikliklerinizi commit edin (
git commit -m 'Add some amazing feature'
) - Branch'inizi push edin (
git push origin feature/amazing-feature
) - Pull Request oluşturun
Test Etme
Server'ın çalışıp çalışmadığını test etmek için:
🚨 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:
Cache Temizleme
NPX cache'ini temizlemek için:
🔄 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 LICENSE dosyasına bakın.
🙏 Teşekkürler
- AARO ERP - API dokümantasyonu ve destek için
- Model Context Protocol - MCP framework için
- Claude Desktop - Entegrasyon platformu için
📞 Destek ve İletişim
- 🐛 Bug Report: GitHub Issues
- 💡 Feature Request: GitHub Discussions
- 📧 Email: info@aaro.com.tr
This server cannot be installed
A Model Context Protocol server that enables Claude Desktop integration with AARO ERP system, allowing users to perform stock management, customer management, order processing, and other core ERP operations through natural language commands.
Related MCP Servers
- -securityAlicense-qualityA custom Model Context Protocol server that gives Claude Desktop and other LLMs access to file system operations and command execution capabilities through standardized tool interfaces.Last updated -23PythonApache 2.0
- AsecurityAlicenseAqualityA Model Context Protocol server that enables Claude Desktop to access structured employee data and perform HR operations including employee lookups, searches, and global leave requests.Last updated -3JavaScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables Claude Desktop to interact with Microsoft Dynamics 365, allowing users to retrieve information, create and update accounts, and manage opportunities through natural language.Last updated -511TypeScriptMIT License
- AsecurityFlicenseAqualityA server built on mcp-framework that enables integration with Claude Desktop through the Model Context Protocol.Last updated -11