MCP & AI Agents

MCP & AI Agents

HeptaCert, Model Context Protocol (MCP) (opens in a new tab) üzerinden herhangi bir uyumlu AI istemcisine tam entegrasyon sunar. MCP açık bir standarttır — sadece Claude'a özgü değildir.

Desteklenen İstemciler

İstemciTürMCP Desteği
Claude Desktop (opens in a new tab)Masaüstü app✅ Yerleşik
Cursor (opens in a new tab)IDE✅ Yerleşik
Windsurf (opens in a new tab)IDE✅ Yerleşik
Continue.dev (opens in a new tab)VS Code ext.✅ Yerleşik
Cline (opens in a new tab)VS Code ext.✅ Yerleşik
Zed (opens in a new tab)Editor✅ Yerleşik
Kendi Agent'ınPython/JS SDK✅ MCP SDK (opens in a new tab)
ChatGPTWeb❌ MCP değil — Actions kullan
💡

HeptaCert MCP sunucusu standart MCP protokolü üzerinden çalışır. Herhangi bir MCP uyumlu istemci — aynı araç seti, aynı kimlik doğrulama.

Kurulum

Tüm istemciler için iki temel ayar gereklidir:

  • URL (hosted mod): https://heptacert.com/mcp
  • Authorization header: Bearer hc_live_YOUR_KEY

Config dosyası: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "heptacert": {
      "url": "https://heptacert.com/mcp",
      "headers": {
        "Authorization": "Bearer hc_live_YOUR_KEY"
      }
    }
  }
}

Kaydedip Claude Desktop'ı yeniden başlatın. Sağ panelde 🔌 simgesi görünür.

ChatGPT / OpenAI Actions

ChatGPT, MCP protokolünü desteklemez — bunun yerine OpenAPI tabanlı Actions kullanır.

HeptaCert'i ChatGPT'ye bağlamak için:

  1. ChatGPT → My GPTs → Create a GPT → Configure → Add Action
  2. Authentication: API Key, Authorization: Bearer hc_live_...
  3. Schema: https://heptacert.com/api/openapi.json adresinden OpenAPI spec'i alın

OpenAI Agents SDK kullanıyorsanız MCP desteği mevcuttur:

from agents.mcp import MCPServerStreamableHttp
 
server = MCPServerStreamableHttp(
    url="https://heptacert.com/mcp",
    headers={"Authorization": "Bearer hc_live_YOUR_KEY"},
)

Örnek Konuşmalar

Kullanıcı: Bugün en çok check-in yapılan etkinlik hangisi?

Agent: list_events çağrısı yapıyorum...
       get_attendance_summary çağrısı yapıyorum (3 etkinlik için)...

       En yüksek katılım: "Python Summit 2026" — 127/150 (%84.7)
Kullanıcı: ahmet@example.com adresli kişi hangi etkinliklere katıldı?

Agent: search_attendees_across_events çağrısı yapıyorum...

       Ahmet Yılmaz (ahmet@example.com) 3 etkinliğe katılmış:
       - Python Summit 2026 (sertifika var)
       - React Workshop (sertifika yok — check-in yapmamış)
       - DevFest 2025 (sertifika var)
⚠️

Silme işlemleri iki adımlıdır. Agent önce ne silineceğini önizler. Onayınız olmadan işlem gerçekleşmez.

Araçlar (44 Araç)

Etkinlikler (8)

list_events · get_event · get_event_stats · create_event · update_event · delete_event · close_registration · open_registration

Katılımcılar (6)

list_attendees · add_attendee · bulk_add_attendees · update_attendee · remove_attendee · export_event_attendees

Sertifikalar (5)

list_certificates · issue_certificates · revoke_certificate · get_certificate_tier_summary · get_certificate_by_public_id

Oturumlar (4)

list_sessions · create_session · update_session · delete_session

Check-in (3)

checkin_lookup · manual_checkin · get_attendance_summary

Otomasyon (4)

list_automation_rules · create_automation_rule · update_automation_rule · delete_automation_rule

Webhooks (3)

list_webhooks · create_webhook · delete_webhook

Analitik & Arama (3)

get_event_analytics · search_attendees_across_events · get_survey_responses

LMS (6)

list_lms_courses · get_lms_course · list_lms_enrollments · enroll_in_lms_course · get_lms_course_analytics · get_lms_analytics

Sistem (2)

get_organization_settings · list_agent_logs

Güvenlik

  • Her MCP isteği Bearer token ile doğrulanır
  • Scope'lar MCP katmanında uygulanır — scope eksikse araç çalışmaz
  • Tüm yazma işlemleri Agent Logs sayfasına kaydedilir (Admin → Ayarlar → Agent Logları)
API ReferansıCLI