Yönetici Sayfaları

isimsoftware MCP Sunucusu

isimsoftware Talep Sistemi MCP (Model Context Protocol) sunucusu, AI asistanlarının Talep Sistemi’nizden doğrudan Destek Taleplerini aramasına ve okumasına olanak tanır. Hem SaaS hem de self-hosted kurulumlarla çalışır.

Bağlanmak için iki yöntem vardır:

  • Hosted HTTP endpoint — isimsoftware Talep Sistemi içine yerleşik olarak gelir. Kurulum gerektirmez. Çoğu kullanıcı için önerilir.
  • Yerel npm paketiisimsoftware-Talep Sistemi-mcp makinenizde stdio üzerinden çalışır. Streamable HTTP transport’u henüz desteklemeyen istemcilerle kullanın.

Bunlar AI Asistanı için giden MCP’lerdir: kendi AI ajanınız isimsoftware Talep Sistemi’ne bağlanır ve isimsoftware’in araçlarını kullanır. Eğer ters yönü istiyorsanız - yani isimsoftware’in AI’sının sizin MCP Sunucunuza bağlanıp kendi araçlarınızı kullanması - AI harici araçlar bölümüne bakın.


API tokenınızı alma

  1. isimsoftware Talep Sistemi’ne giriş yapın
  2. Sağ üstteki avatarınıza tıklayarak kullanıcı Profilinize gidin
  3. "API Token" butonuna tıklayın
  4. Token’ı kopyalayın

Seçenek 1: Barındırılan HTTP endpoint

isimsoftware Talep Sistemi, MCP endpoint’ini HTTPS üzerinden /api/mcp adresinde sunar. Streamable HTTP transport destekleyen tüm MCP istemcileri doğrudan bağlanabilir.

Yerinde (On-premise)

isimsoftware Talep Sistemi v11.21 ve üzeri sürümlerde kullanılabilir. SaaS sürümünde bu özellik her zaman aktiftir.

  • URL: https://firmaisim.isimsoftware.com/api/mcp
  • Kimlik doğrulama başlığı: Authorization: Bearer <your-API-token>
  • Taşıma yöntemi: Streamable HTTP (stateless)

Claude Code

claude mcp add --transport http isimsoftware-Talep Sistemi https://firmaisim.isimsoftware.com/api/mcp \
  --header "Authorization: Bearer your-API-token"

Claude Desktop, Cursor, Windsurf

Yapılandırma dosyanıza ekleyin:

  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya %APPDATA%\Claude\claude_desktop_config.json (Windows)
  • Cursor: Ayarlar > MCP Sunucuları
  • Windsurf: Ayarlar > MCP Sunucuları
{
  "mcpServers": {
    "isimsoftware-Talep Sistemi": {
      "type": "http",
      "url": "https://firmaisim.isimsoftware.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-API-token"
      }
    }
  }
}

Seçenek 2: Yerel npm paketi (stdio)

Bu yöntem, MCP istemciniz henüz HTTP transport desteklemiyorsa veya servisi yerel çalıştırmayı tercih ediyorsanız kullanılır.

Claude Code

claude mcp add isimsoftware-Talep Sistemi \
  -e ISIMSOFTWARE_URL=https://firmaisim.isimsoftware.com \
  -e ISIMSOFTWARE_TOKEN=your-API-token \
  -- npx -y isimsoftware-Talep Sistemi-mcp

Claude Desktop, Cursor, Windsurf

{
  "mcpServers": {
    "isimsoftware-Talep Sistemi": {
      "command": "npx",
      "args": ["-y", "isimsoftware-Talep Sistemi-mcp"],
      "env": {
        "ISIMSOFTWARE_URL": "https://firmaisim.isimsoftware.com",
        "ISIMSOFTWARE_TOKEN": "your-API-token"
      }
    }
  }
}

Ortam Değişkenleri

DeğişkenGerekliAçıklama
ISIMSOFTWARE_URLEvetisimsoftware örneğinizin temel URL’si (SaaS: https://firmaisim.isimsoftware.com, yerinde kurulum: sunucu URL’niz)
ISIMSOFTWARE_TOKENEvetisimsoftware kullanıcı profilinizden alınan API token

Kullanılabilir Araçlar

Yapılandırma tamamlandığında MCP Sunucusu AI Asistanının otomatik olarak çağırabileceği üç adet salt-okunur araç sunar.

Talepleri Ara

Araç adı: isimsofrware_search_tickets

Anahtar kelime veya ifade ile Talepleri arar. Talep konu ve içeriklerinde eşleşme yapar.

Parametreler:

  • query (string, zorunlu) — arama ifadesi (minimum 3 karakter)
  • limit (number, varsayılan 25) — maksimum sonuç (1-100)

Örnek kullanım: "Şifre sıfırlama ile ilgili Talepleri ara" — AI, isimsofrware_search_tickets aracını "password reset" sorgusuyla çağırır ve sonuçları döner.

Talepleri Listele

Araç adı: isimsofrware_list_tickets

Durum ve filtreye göre Talepleri listeler.

Parametreler:

  • mode (string, opsiyonel) — "all", "unanswered", "unclosed", "unassigned", veya "handledbyme"
  • status (string, opsiyonel) — Talep durum adına göre filtre
  • limit (number, varsayılan 25) — maksimum sonuç
  • offset (number, varsayılan 0) — sayfalama

Örnek kullanım: "Cevaplanmamış Talepleri göster" — AI, isimsofrware_list_tickets aracını "unanswered" modu ile çağırır.

Talep Getir

Araç adı: isimsofrware_get_ticket

Bir Talebin tüm detaylarını ve konuşma geçmişini getirir.

Parametreler:

  • ticketId (number, zorunlu) — Talep numarası

Örnek kullanım: "Talep #4521’i göster" — AI, isimsofrware_get_ticket aracını 4521 ID’si ile çağırır ve tüm detayları döner.


Bununla neler yapabilirsiniz

Bağlantı sağlandıktan sonra AI Asistanına şu tür sorular sorabilirsiniz:

  • "SSO giriş sorunlarıyla ilgili Talepleri ara"
  • "Tüm cevaplanmamış Talepleri göster"
  • "Talep #1234’ün detaylarını getir"
  • "Faturalama ile ilgili Talepleri bul"
  • "Kapatılmamış Talepleri listele ve özetle"

AI Asistanı araç seçimini otomatik yapar — sadece doğal dilde sorun.


Güvenlik

  • MCP Sunucusu salt okunurdur — Talep oluşturamaz, düzenleyemez veya silemez
  • Tüm çağrılar sizin API tokenınız ile yapılır, bu yüzden AI yalnızca sizin erişebildiğiniz veriyi görür
  • Hosted endpoint’te token HTTPS üzerinden Bearer header ile gönderilir
  • Npm paketinde token yerel olarak MCP yapılandırmasında tutulur ve üçüncü taraflara gönderilmez
Önceki
AI Asistanı