ikas Builders

Giriş

ikas Admin API için giriş ve genel bilgiler

ikas Admin API'lerine AI agent aracılığıyla bağlanmak için MCP istemcisini kullanın. MCP istemcisi (ör. Cursor veya Claude ayarlarında MCP Client) ile aşağıdaki uzak sunucuya bağlanın.

MCP Client'ının query ve mutation çalıştırabilmesi için, geçerli bir Authentication token sağlamanız gerekmektedir. Bu token'nı mağazanızın içindeki Uygulamalarım > Özel Uygulama kısmından oluşturacağınız MCP İstemcisi türündeki uygulamadan alabilirsiniz.

MCP Client Bilgileri

MCP sunucusu

Uzak adres: https://api.myikas.com/api/v2/admin/mcp

Kapsam

Public API'de bulunan tüm toollar bu MCP sunucusunda tanımlıdır.

MCP istemcisini yapılandırma

  • MCP istemcisinde yeni bir uzak sunucu ekleyin (Cursor/Claude → MCP → Add Remote).
  • Uzak adres olarak https://api.myikas.com/api/v2/admin/mcp değerini kullanın.
  • Authorization başlığını Bearer <ACCESS_TOKEN> olacak şekilde iletin. Bunu ortam değişkeni üzerinden sağlamanız önerilir. Access Token, panelden aldığını mcp_ ile başlayan tokendır.

Örnek uzak MCP yapılandırması:

{
  "mcpServers": {
    "ikas-admin": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.myikas.com/api/v2/admin/mcp",
        "--header",
        "Authorization:${IKAS_ADMIN_AUTH_TOKEN}"
      ],
      "env": {
        "IKAS_ADMIN_AUTH_TOKEN": "<ACCESS_TOKEN>"
      }
    }
  }
}

Güvenlik

Access token'ınızı kaynağa commit etmeyin. Ortam değişkenleri kullanın ve loglarda token'ı göstermeyin.

Demo

Giriş