---
title: Giriş
description: 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.

<img className="mx-auto my-6 rounded-lg border border-zinc-200 shadow-sm dark:border-zinc-800" src="/media/ikas-ai/mcp-client.png" alt="MCP Client Bilgileri" width="1024" height="600" />


<Callout type="info" title="MCP sunucusu">
Uzak adres: `https://api.myikas.com/api/v2/admin/mcp`
</Callout>

<Callout type="info" title="Kapsam">
Public API'de bulunan tüm toollar bu MCP sunucusunda tanımlıdır.
</Callout>

### 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ı:

```json
{
  "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>"
      }
    }
  }
}
```

<Callout type="warning" title="Güvenlik">
Access token'ınızı kaynağa commit etmeyin. Ortam değişkenleri kullanın ve loglarda token'ı göstermeyin.
</Callout>

### Demo

<video src="/media/ikas-ai/claude.mp4" controls playsInline className="w-full rounded-md" />