MCP Server

Model Context Protocol ile AI editörlerinizi İdeasoft API'lerine bağlayın

Bağlantı Aktif

İdeasoft MCP Server başarıyla yapılandırıldı ve kullanıma hazır.

Domain —
Token Durumu —
Access Token:
—
Kurulum Adımları
1

İdeasoft Paneline Giriş

İdeasoft admin panelinize giriş yapın ve Entegrasyonlar › API bölümüne gidin.

2

Yeni API Uygulaması Oluşturun

"Yeni Uygulama Ekle" butonuna tıklayın ve aşağıdaki callback URL'yi girin:

Redirect URI
https://mcp.myideasoft.com/setup/callback
3

İzinleri Tanımlayın

Oluşturduğunuz uygulamada "İzin Yönetimi" bölümüne gidin ve ihtiyacınız olan API izinlerini seçin:

  • Ürün okuma / yazma
  • Kategori okuma / yazma
  • Sipariş okuma
4

API Bilgilerini Alın

Uygulama oluşturduktan sonra Client ID ve Client Secret bilgilerinizi kopyalayın ve aşağıdaki forma yapıştırın.

AI Tools CLI Konfigürasyonu

ideasoft-ai-tools CLI aracı ile MCP Server ve Skill konfigürasyonunu otomatik olarak yapabilirsiniz.

1. Paketi Global Olarak Kurun

(Paketin güncel halini takip etmek için tıklayın.)

Terminalde aşağıdaki komutu çalıştırın:

npm i -g @ideasoft.com.tr/ideasoft-ai-tools

2. Proje Dizininde Setup Çalıştırın

Proje dizininize gidin ve setup komutunu çalıştırın:

cd /proje-dizininiz
ideasoft-ai-tools setup            # Tüm editörler (Cursor + Claude + Windsurf)
ideasoft-ai-tools setup cursor     # Sadece Cursor
ideasoft-ai-tools setup claude     # Sadece Claude Code
ideasoft-ai-tools setup windsurf   # Sadece Windsurf

3. Auth İşlemini Tamamlayın

Domain ve token bilgilerinizi şu komutla tanımlayın ve kullanmaya başlayın:

ideasoft-ai-tools env <domain> <token>

AI Editörü Konfigürasyonu

MCP Server'ınızı AI editörlerinizle bağlamak için aşağıdaki konfigürasyonları kullanın.

1. mcp-remote Paketini Kurun

Aşağıdaki komutu terminalde çalıştırın:

npm install -g mcp-remote

2. IDE Ayar Dosyasına Ekleyin

IDE'nizde MCP ayarları dosyasına şu bloğu ekleyin:

{
  "mcpServers": {
    "ideasoft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.myideasoft.com/mcp",
        "--header",
        "security:${DOMAIN},${ACCESS_TOKEN}"
      ],
      "env": {
        "DOMAIN": "",
        "ACCESS_TOKEN": ""
      }
    }
  }
}

3. Url ile bağlanmak isteyenler Header alanına aşağıdaki gibi girmelidir

Header'da key alanına security, value alanına aşağıdaki değeri girin:

${DOMAIN},${ACCESS_TOKEN}
Önemli Notlar

• MCP Server'ın çalışır durumda olduğundan emin olun (https://mcp.myideasoft.com)

• Konfigürasyon değişikliklerinden sonra AI editörünüzü yeniden başlatın

• OAuth token süreniz dolduğunda bu sayfadan yenileyebilirsiniz

• Server offline olduğunda AI editörünüz otomatik yeniden bağlanmaya çalışacaktır

Kullanıma Hazır!
Kurulum tamamlandığında AI editörünüzde İdeasoft API'lerine doğal dil ile erişebilir, ürün yönetimi, sipariş takibi ve diğer e-ticaret işlemlerinizi kolayca yapabilirsiniz.