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 paketi — isimsoftware-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
- isimsoftware Talep Sistemi’ne giriş yapın
- Sağ üstteki avatarınıza tıklayarak kullanıcı Profilinize gidin
- "API Token" butonuna tıklayın
- 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şken | Gerekli | Açıklama |
|---|---|---|
ISIMSOFTWARE_URL | Evet | isimsoftware örneğinizin temel URL’si (SaaS: https://firmaisim.isimsoftware.com, yerinde kurulum: sunucu URL’niz) |
ISIMSOFTWARE_TOKEN | Evet | isimsoftware 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 filtrelimit(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