KnowSync AI

resmi

Dağınık dokümantasyonunuzu, Claude, Cursor, VS Code ve diğer AI araçlarıyla sorunsuz çalışan, AI'ya hazır bilgiye dönüştürün.

KnowSync AI MCP ile neler yapabilirsiniz?

  • Bilgi tabanında ara — Yapay zekânızdan, otomatik niyet algılama ve yapay zekâ destekli yeniden sıralama ile knowsync_query kullanarak ilgili belgeleri ve içerikleri bulmasını isteyin.
  • Belgeleri yönetin — Bilgi tabanı denetimleri için knowsync_manage kullanarak belgeleri duruma veya içerik türüne göre listeleyin, göz atın ve filtreleyin.
  • Web içeriği ekleyin — Yapay zekânızdan belirli URL'leri taramasını veya ilgili web sayfalarını keşfetmesini isteyin; böylece knowsync_manage ile bunları otomatik olarak bilgi tabanınıza ekleyebilirsiniz.
  • Oturum duyarlı takip soruları — Aynı konuşmada bağlamsal takip soruları sorun; knowsync_query bağlamı koruyarak doğal çok turlu sorgulara olanak tanır.

Dokümantasyon

Connect AI agents to your KnowSync knowledge base using the Model Context Protocol (MCP). Set up API keys, configure tools, and integrate with Claude, Cursor, and other AI assistants.

15 min readBy KnowSync Team9/18/2025

MCP Entegrasyonu

KnowSync'in Model Context Protocol (MCP) sunucusu, AI ajanlarının kuruluşunuzun bilgi tabanına gerçek zamanlı olarak erişmesini sağlar. Claude, Cursor, VS Code ve diğer AI araçlarını bağlayarak bilgi tabanınızda sorunsuz bir şekilde arama yapabilir, içerik alabilir ve ekleyebilirsiniz.

MCP Nedir?

Genel Bakış

Model Context Protocol (MCP), Anthropic tarafından geliştirilen ve AI uygulamalarının harici veri kaynaklarına güvenli bir şekilde erişmesini sağlayan açık bir standarttır. KnowSync'in MCP sunucusu, akıllı önbellekleme, AI destekli sorgu optimizasyonu ve oturum yönetimi ile 2 birleşik araç sağlar; bu araçlar AI ajanlarının standartlaştırılmış bir JSON-RPC 2.0 API'si aracılığıyla bilgi tabanınızla etkileşime girmesini sağlar.

Temel Özellikler

2 Birleşik Araç:

  • Evrensel Sorgu: Otomatik niyet algılama, AI destekli yeniden sıralama, akıllı önbellekleme ve oturum farkındalıklı bağlam koruma ile akıllı arama ve alma
  • Belge Yönetimi: Web tarama, keşif ve kullanım takibi dahil kapsamlı içerik yönetimi

Kurumsal Güvenlik:

  • Ayrıntılı izinlerle API anahtarı kimlik doğrulaması
  • Hız sınırlama ve kullanım takibi
  • Tüm istekler için ekip üyesi atıflandırması
  • IP kısıtlamaları ve erişim kontrolleri

MCP API Anahtarlarını Ayarlama

İlk API Anahtarınızı Oluşturma

  1. MCP Panosuna Erişin: Kuruluş panelinize gidin ve MCP Sunucusu kartına tıklayın
  2. API Anahtarları Sekmesine Gidin: API Anahtarları bölümüne tıklayın
  3. Yeni Anahtar Oluşturun: API Anahtarı Oluştur düğmesine tıklayın
  4. Anahtar Ayarlarını Yapılandırın:
    • Ad: Tanımlayıcı bir ad (ör. "Claude Desktop", "Geliştirme Testi")
      • İzinler: Anahtarın erişebileceği araçları seçin
      • Hız Sınırı: Saat başına istek sayısını ayarlayın (planınıza göre)

Mevcut MCP Araçları

KnowSync, önceki 5 araçlı sistemimizin işlevselliğini birleştiren 2 güçlü birleşik MCP aracı sağlar:

Evrensel Araçlar (Tüm Planlar)

knowsync_query:

  • Akıllı önbellekleme ile evrensel arama ve içerik alma (%60-85 daha hızlı yanıtlar)
  • Sorgu genişletme ve optimizasyon ile otomatik niyet algılama (arama vs. alma)
  • Konuşma belleği ile takip sorguları için oturum farkındalıklı bağlam koruma
  • AI sorgu sınıflandırması ve güven puanlamasına dayalı akıllı parametre ayarlama
  • İyileştirilmiş alaka için AI destekli sonuç yeniden sıralama (Pro+ planları)
  • Yıldırım hızında tekrarlanan sorgular için gömme benzerliği önbelleği

Yönetim Araçları (Tüm Planlar)

knowsync_manage:

  • Kullanım takibi ile kapsamlı belge yönetimi işlemleri
  • Gelişmiş filtreleme ve durum izleme ile belgeleri listeleme ve göz atma (0,5 API birimi)
  • Tam vektör işleme ile bilgi tabanınıza belirli web sayfaları ekleme (URL başına 2 API birimi: 1 tarama + 1 işleme)
  • Otomatik işleme ile ilgili web içeriğini araştırma ve keşfetme (keşfedilen URL başına 2 API birimi)
  • Ayrıntılı API tüketim takibi ile tüm belge işlemleri için birleşik arayüz

İzin Yapılandırması

Araç Düzeyinde İzinler: Her API anahtarına ihtiyaçlarınıza göre belirli araçlara erişim verilebilir:

  • Yalnızca Arama: Salt okunur AI ajanları için idealdir
  • Tam Erişim: Mevcut tüm araçlara tam erişim
  • Özel: Özel kullanım durumları için belirli araçları seçin

Hız Sınırlama: Kullanım kalıplarına göre istek limitlerini yapılandırın:

  • Ücretsiz Plan: Saatte maksimum 60 istek
  • Başlangıç Planı: Saatte 600 isteğe kadar
  • Profesyonel Plan: Saatte 3.000 isteğe kadar
  • Kurumsal Plan: Özel limitler mevcuttur

AI Araçlarıyla Entegrasyon

Claude Desktop Kurulumu

Ön Koşullar:

  • Claude Desktop uygulaması (en son sürüm)
  • Uygun izinlere sahip KnowSync API anahtarı
  • Ekip takibi için kullanıcı kimliği

Yapılandırma:

  1. Sunucu URL'nizi Alın: https://www.knowsync.ai/api/mcp
  2. Claude Desktop Ayarlarına Ekleyin:
{
  "mcpServers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

Cursor IDE Entegrasyonu

Kurulum Talimatları:

  1. Cursor Ayarlarını Açın (Cmd/Ctrl + ,)
  2. MCP Bölümüne Gidin
  3. KnowSync Sunucusunu Ekleyin:
{
  "mcpServers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

VS Code Entegrasyonu

MCP Uzantısını Kullanma:

  1. VS Code için MCP Uzantısını Kurun
  2. settings.json içinde yapılandırın:
{
  "mcp.servers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

Claude Code Kurulumu

Ön Koşullar:

  • Claude Code CLI kurulu (npm install -g @anthropic-ai/claude-code üzerinden kurun veya resmi kurulum kılavuzunu izleyin)
  • Uygun izinlere sahip KnowSync API anahtarı
  • KnowSync kullanıcı/e-posta kimliğiniz (profil ayarlarında bulunur)

Yapılandırma:

  1. Claude CLI kullanarak KnowSync MCP Sunucusunu Ekleyin:
  • Kullanıcı Kimliği ile:
claude mcp add --transport http knowsync https://www.knowsync.ai/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "X-User-Id: your_user_id_here"
  • Kullanıcı E-postası ile:
claude mcp add --transport http knowsync https://www.knowsync.ai/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "X-User-Email: your_user_email_here"
  1. Yapılandırmayı Doğrulayın:
claude mcp list

Bu, listede knowsync sunucusunu göstermelidir.

Not: API anahtarınızın gerekli araç izinlerine sahip olduğundan emin olun. Yer tutucuları gerçek değerlerle değiştirin.

Ekip Üyesi Takibi

Gerekli Başlıklar: Tüm MCP istekleri, doğru atıflandırma için kullanıcı kimliği içermelidir:

  • X-User-Id: KnowSync kullanıcı kimliğiniz (profil ayarlarında bulunur)
  • X-User-Email: Kayıtlı e-posta adresiniz

Neden Gerekli:

  • Bireysel ekip üyesi kullanımını takip edin
  • Kullanıcı başına analizler ve içgörüler oluşturun
  • Doğru denetim izlerini sağlayın
  • Kullanım tabanlı faturalandırma ve limitleri etkinleştirin

Gerçek Dünya MCP Kullanım Örnekleri

Geliştirme İş Akışı Entegrasyonu

Senaryo 1: Kod İnceleme Asistanı

Kullanım Durumu: AI ajanı, kod incelemeleri sırasında ekibinizin kodlama standartlarına ve en iyi uygulamalarına erişerek yardımcı olur.

# Query for coding standards
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What are our React component naming conventions and prop validation requirements?",
        "mode": "retrieve",
        "limit": 4
      }
    }
  }'

AI Ajan Entegrasyonu: Geliştirme sırasında ekibinizin standartlarına anında erişim için Claude Code'u bunu kullanacak şekilde yapılandırın.

Senaryo 2: Yeni Ekip Üyelerini İşe Alıştırma

Kullanım Durumu: Yeni çalışanlar için bilgi tabanını en son çerçeve dokümantasyonuyla otomatik olarak doldurun.

# Discover and add latest documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "discover",
        "query": "Next.js 15 App Router migration guide 2024",
        "options": {
          "maxResults": 8,
          "maxUrls": 4,
          "relevanceThreshold": 0.8
        }
      }
    }
  }'

API Tüketimi ile Beklenen Yanıt:

{
  "success": true,
  "documentsCreated": 4,
  "apiUnitsConsumed": 8,
  "message": "Successfully discovered and processed 4 documents into knowledge base (8 API units consumed)"
}

Not: 4 URL × 2 birim (1 tarama + 1 işleme) = toplam 8 API birimi

Müşteri Desteği İyileştirme

Senaryo 3: Anında Destek Dokümantasyon Erişimi

Kullanım Durumu: Destek ajanları, müşterilere yardım ederken ürün dokümantasyonundan anında yanıtlar alır.

# Search for troubleshooting information
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: support_agent_123" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "Customer getting 401 errors during payment processing, what are the common causes and solutions?",
        "mode": "auto",
        "limit": 6
      }
    }
  }'

Faydalar: Önbellekleme sayesinde %60-85 daha hızlı yanıt süresi, AI geliştirilmiş alaka sıralaması en yararlı çözümleri önce gösterir.

Ürün Yönetimi İş Akışları

Senaryo 4: Rekabet Analizi Araştırması

Kullanım Durumu: Ürün yöneticileri rakip özelliklerini ve sektör trendlerini araştırır.

# Discover latest competitive analysis
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: product_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "discover",
        "query": "SaaS pricing strategy trends 2024 freemium models",
        "options": {
          "maxResults": 10,
          "maxUrls": 5,
          "relevanceThreshold": 0.7
        }
      }
    }
  }'

Senaryo 5: Özellik Gereksinimleri Sorgulama

Kullanım Durumu: Planlama sırasında mevcut özellik spesifikasyonlarını ve gereksinimlerini hızlıca bulun.

# Search existing requirements
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: product_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "user authentication flow requirements two-factor authentication implementation",
        "mode": "retrieve",
        "filters": {
          "contentTypes": ["documents"],
          "documentIds": ["spec_docs_collection"]
        }
      }
    }
  }'

Satış ve Pazarlama Desteği

Senaryo 6: Satış Etkinleştirme

Kullanım Durumu: Satış ekibi, müşteri görüşmeleri sırasında ürün bilgilerine ve rekabetçi konumlandırmaya erişir.

# Quick product feature lookup
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: sales_rep" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 6,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What security certifications do we have? SOC 2 compliance status enterprise security features",
        "mode": "search",
        "limit": 5
      }
    }
  }'

Bilgi Tabanı Bakımı

Senaryo 7: İçerik Boşluğu Analizi

Kullanım Durumu: Hangi dokümantasyonun mevcut olduğunu ve neyin oluşturulması gerektiğini belirleyin.

# Audit existing documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: content_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 7,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "list",
        "filters": {
          "limit": 50,
          "status": "ready",
          "contentType": "markdown"
        }
      }
    }
  }'

Senaryo 8: Sektör Dokümantasyonu Ekleme

Kullanım Durumu: Bilgi tabanını en son sektör standartları ve çerçeveleriyle güncel tutun.

# Add specific technical documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: tech_writer" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 8,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "crawl",
        "url": "https://nextjs.org/docs/app/building-your-application/authentication",
        "options": {
          "respectRobots": true,
          "timeout": 45,
          "followLinks": false
        }
      }
    }
  }'

KnowSync MCP Neden Devrim Niteliğinde

Güç Farkı

Geleneksel dokümantasyon sistemleri bilgiyi aramanızı sağlar. KnowSync MCP bilgiyi size getirir:

KnowSync MCP'den Önce:

  • Dokümantasyonu aramak için araçlar arasında geçiş yapın
  • Benzer sorular için aramaları tekrarlayın
  • Birden fazla kaynaktan gelen bilgileri manuel olarak birleştirin
  • Arama başına 2-5 saniye bekleyin
  • İlgili olabilecek veya olmayabilecek sonuçlar alın

KnowSync MCP ile:

  • AI ajanları bilgi tabanınıza otomatik olarak erişir
  • Akıllı önbellekleme ile %60-85 daha hızlı yanıtlar
  • AI bağlamı anlar ve tam ihtiyacınız olanı sağlar
  • Oturum belleği konuşma bağlamını korur
  • Sonuçlar maksimum alaka için AI tarafından sıralanır

İş Akışınız Üzerindeki Gerçek Etki

# Traditional approach: Manual search in documentation
# Time: 2-5 minutes per question
# Result: May not find the right answer

# KnowSync MCP approach: AI agent instantly knows
# Time: 2-5 seconds per question
# Result: Contextual, accurate, source-cited answers

Örnek: "Kimlik doğrulamayı nasıl ele alıyoruz?" diye soran bir geliştirici, yalnızca kimlik doğrulama belgelerini değil, aynı zamanda mevcut proje bağlamlarıyla ilgili bölümleri, takip önerileriyle birlikte 2 saniyeden kısa sürede alır.

Gelişmiş Entegrasyon Kalıpları

Oturum Farkındalıklı Konuşmalar

AI, aynı oturumdaki sorgular arasında bağlamı hatırlar ve doğal takip sorularını mümkün kılar:

# First query
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: developer_session_123" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "How do we handle user authentication in our React apps?"
      }
    }
  }'

# Follow-up query (AI maintains context)
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: developer_session_123" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What about logout and session management for that?"
      }
    }
  }'

Performans Optimizasyonu Örnekleri

Akıllı önbelleklemenin gücünü gösterin:

# First time query (full processing)
time curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "deployment pipeline configuration Docker containerization"
      }
    }
  }'
# Response time: ~800ms

# Similar query (cached response)
time curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "how to configure deployment pipelines with Docker containers"
      }
    }
  }'
# Response time: ~120ms (85% faster!)

Ekibinizin Üretkenliğini Dönüştürün

KnowSync MCP Öncesi vs. Sonrası

| Senaryo | Geleneksel Yöntem | KnowSync MCP ile | Kazanılan Zaman | |----------|-------------------|-------------------|------------| | Kod İnceleme | Belgeleri manuel olarak arayın | AI ajanı kodlama standartlarını anında alıntılar | %90 daha hızlı | | Müşteri Desteği | Sorun giderme kılavuzlarını arayın | AI tam çözüm adımlarını sağlar | %85 daha hızlı | | İşe Alıştırma | Dokümantasyona bağlantılar gönderin | AI belirli soruları bağlamsal olarak yanıtlar | %95 daha hızlı | | Ürün Planlama | Rakiplerin özelliklerini manuel olarak araştırın | AI en son trendleri keşfeder ve analiz eder | %80 daha hızlı |

Bileşik Etki

1. Hafta: Ekibiniz dokümantasyon aramalarında günde 2-3 saat tasarruf eder 1. Ay: Ekip üyesi başına 40-60 saat tasarruf 1. Yıl: Her ekip üyesi 2-3 haftalık üretken zamanı geri kazanır

Gerçek Kullanıcı Etki Hikayeleri

Geliştirme Ekibi: "API kalıplarımızı aramak için 30 dakika harcamak yerine, Claude Code bana tam ihtiyacım olanı anında gösteriyor. Aramak yerine inşa etmeye odaklanabiliyorum."

Destek Ekibi: "Araştırması 10 dakika süren müşteri soruları artık 30 saniyede yanıtlanıyor. Yanıt kalitemiz arttı ve yanıt süremiz önemli ölçüde düştü."

Ürün Ekibi: "Saatler süren araştırmalar artık dakikalar içinde tamamlanıyor. Rekabetçi özellikleri analiz edebiliyor, gereksinimleri bulabiliyor ve her zamankinden daha hızlı kararlar alabiliyoruz."

Başlamak Basit

  1. API Anahtarı Oluşturun (2 dakika)
  2. AI ajanınızı bağlayın (Claude, Cursor, VS Code)
  3. Soru sormaya başlayın - hepsi bu!

Güç teknolojide değil - günlük işinizi aramaktan yaratmaya dönüştürmesindedir.

Kullanım Analitiği ve İzleme

MCP Pano Özellikleri

API Anahtarı Yönetimi:

  • API anahtarları oluşturun, düzenleyin ve silin
  • Anahtar başına kullanım istatistiklerini izleyin
  • İzinleri ve hız limitlerini yapılandırın
  • İstek geçmişini ve kalıplarını görüntüleyin

Kullanım Analitiği:

  • Araca göre gerçek zamanlı istek metrikleri
  • Başarı/hata oranları ve yanıt süreleri
  • Kullanıcı başına atıflandırma ve ekip içgörüleri
  • Geçmiş trendler ve kullanım kalıpları

Ayarlar Yapılandırması:

  • Web tarama limitleri ve zaman aşımı ayarları
  • Web keşfi için alan adı izin/engel listeleri
  • İçerik türü filtreleme tercihleri
  • Hız sınırlama ve güvenlik kontrolleri

Ekip Kullanım Takibi

Bireysel Analitikler:

  • Hangi ekip üyelerinin MCP araçlarını kullandığını takip edin
  • Kuruluş genelinde benimseme kalıplarını izleyin
  • Güçlü kullanıcıları ve eğitim ihtiyaçlarını belirleyin
  • Yönetim için kullanım raporları oluşturun

İstek Atıflandırması: Tüm MCP istekleri kullanıcı kimliği başlıkları gerektirir:

  • X-User-Id: Doğrudan kullanıcı kimliği atıflandırması
  • X-User-Email: E-posta tabanlı kullanıcı atıflandırması
  • Kullanıcı başlıkları olmayan istekler reddedilir
  • Uyumluluk için eksiksiz denetim izi

Güvenlik ve Erişim Kontrolü

Kimlik Doğrulama Sistemi

API Anahtarı Güvenliği:

  • Saklanan anahtarlar için Bcrypt karma
  • Otomatik anahtar döndürme yetenekleri
  • Kötüye kullanımı önlemek için anahtar başına hız sınırlama
  • Şüpheli etkinlik için gerçek zamanlı izleme

İzin Modeli:

  • Araç düzeyinde izinler (ayrıntılı erişim kontrolü)
  • Kuruluş tabanlı erişim kısıtlamaları
  • Plan tabanlı özellik kullanılabilirliği
  • Özel izin kombinasyonları

Kurumsal Güvenlik (Kurumsal Planlar)

Gelişmiş Özellikler:

  • IP tabanlı erişim kısıtlamaları
  • Tek Oturum Açma (SSO) entegrasyonu
  • Uyumluluk gereksinimleri için denetim günlükleri
  • Özel güvenlik politikaları ve kontrolleri

Veri Koruması:

  • Tüm iletişimler için TLS şifreleme
  • API anahtarlarının ve kullanıcı verilerinin güvenli depolanması
  • GDPR ve CCPA uyumluluk özellikleri
  • Düzenli güvenlik denetimleri ve güncellemeler

Sorun Giderme

Yaygın Sorunlar

Bağlantı Sorunları:

  • Hata: AI ajanı MCP sunucusuna bağlanamıyor
  • Çözümler:
    • API anahtarının doğru olduğunu ve süresinin dolmadığını doğrulayın
      • Alan adı URL'nizin erişilebilir olduğunu onaylayın (uzak araçlar için localhost değil)
      • Kullanıcı kimliği başlıklarının eklendiğini kontrol edin
      • Gerekli araçlar için API anahtarı izinlerini gözden geçirin

Kimlik Doğrulama Hataları:

  • Hata: "Yetkisiz" veya "Kullanıcı kimliği gerekli"
  • Çözümler:
    • Tüm isteklere X-User-Id veya X-User-Email başlığını ekleyin
      • Kullanıcı kimliğinin/e-postasının kuruluşunuzda mevcut olduğunu doğrulayın
      • Gerekirse API anahtarını yeniden oluşturun
      • API anahtarının uygun araç izinlerine sahip olduğunu kontrol edin

Hız Sınırlama:

  • Hata: "Hız limiti aşıldı"
  • Çözümler:
    • MCP panosunda mevcut kullanımı gözden geçirin
      • API anahtarınız için hız limitlerini ayarlayın
      • Daha yüksek limitler için planınızı yükseltmeyi düşünün
      • Uygulamanızda istek azaltma uygulayın

Araç İzni Hataları:

  • Hata: "X aracı için izin reddedildi"
  • Çözümler:
    • MCP panosunda API anahtarı izinlerini düzenleyin
      • Planınızın gelişmiş araçlara erişim içerdiğinden emin olun
      • Planınıza özel kısıtlamalar için destek ile iletişime geçin

MCP Sunucunuzu Test Etme

Sağlık Kontrolü:

# Test server connectivity
curl https://www.knowsync.ai/api/mcp

# Expected response includes server info and available tools

Araç Testi:

# Test initialize method
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {"tools": true},
      "clientInfo": {"name": "test-client", "version": "1.0.0"}
    }
  }'

Gelecekteki MCP Araçları

KnowSync, 2025 için planlanan ek MCP araçlarını aktif olarak geliştirmektedir:

Faz 1 (2025 Q1):

  • knowsync_summarize: Belgelerin akıllı özetlerini oluşturun
  • knowsync_bulk_operations: Birden fazla belge üzerinde toplu işlemler gerçekleştirin
  • knowsync_compare: Belgeleri benzerlikler ve farklılıklar için karşılaştırın

Faz 2 (2025 Q2):

  • knowsync_analytics: Kullanım içgörüleri ve bilgi tabanı analitiği edinin
  • knowsync_quality_check: İçerik kalitesini analiz edin ve iyileştirin

Tam ayrıntılar için MCP Araçları Yol Haritası bölümüne bakın.

Destek Alma

Dokümantasyon:

  • Gerçek örneklerle eksiksiz MCP test kılavuzu
  • Tüm araçlar için API referans dokümantasyonu
  • Popüler AI platformları için entegrasyon kılavuzları

Destek Kanalları:

  • Başlangıç/Profesyonel: MCP uzmanlığı ile e-posta desteği
  • Kurumsal: Özel MCP entegrasyon desteği
  • Tüm Planlar: Topluluk forumları ve dokümantasyon

Özel Entegrasyon: Kurumsal müşteriler, özel MCP araç geliştirme ve gelişmiş entegrasyon desenleri için ekibimizle çalışabilir.

🚀 AI Araçlarınızı Bağlamaya Hazır mısınız?

MCP panosunda ilk API anahtarınızı oluşturarak başlayın, ardından basit bir arama sorgusuyla bağlantıyı test edin. Doğru ekip atıfı için kullanıcı kimliği başlıklarını eklemeyi unutmayın.