Yönetim MCP sunucusu

KeenAuth yönetim MCP sunucusu, bir yapay zeka asistanının Model Context Protocol üzerinden ortamınızın yapılandırmasını okumasına olanak tanır. Sunucu, stdio üzerinden yerel olarak çalışır ve yönetim API'sini anahtarınızla çağırır. Henüz bir kurulum paketi yoktur.

Varsayılan olarak yalnızca okuma

--allow-write olmadan sunucu yalnızca salt okunur araçları sunar. Hiçbir araç, hangi modda olursa olsun bir şeyi silmez.

Araç	Döndürdüğü içerik
`users_list`, `users_get`, `users_search`	Kullanıcılar; kişisel veriler maskelenmiş olarak
`applications_list`, `applications_get`, `application_credentials_list`	Uygulamalar
`apis_list`, `apis_get`	API'ler
`connections_list`, `connections_get`	Bağlantılar
`api_keys_list`, `api_keys_get`	API anahtarları: yalnızca meta veriler; ham anahtar asla döndürülmez
`organizations_list`, `organizations_get`	Kuruluşlar: ad, slug, dış kimlik, durum ve zaman damgaları; kuruluşun `metadata` alanı asla döndürülmez
`custom_domains_list`, `custom_domains_get`	Özel alan adları ve DNS kayıtları
`support_access_grants_list`, `support_access_grants_get`	Destek erişim izinleri
`environment_settings_get`	Ortam ayarları: yerel ayarlar, saat dilimi, oturum, kayıt, güvenlik bildirimleri, hesap kurtarma, MFA, ön kanal çıkışı ve izin verilen birinci faktörler

--unmask-pii bu sürümde 2 çıkış koduyla sonlanır.

Yazma araçları

Yazma araçlarını da sunmak için sunucuyu --allow-write ile başlatın. Bu sürümde bir tane vardır:

Araç	Neyi değiştirir
`environment_settings_update`	Yalnızca etkin yerel ayarları, varsayılan yerel ayarı ve varsayılan saat dilimini. Oturum, kayıt, hesap kurtarma, MFA, güvenlik bildirimi ve birinci faktör ayarları MCP üzerinden değiştirilemez.

Her yazma işlemi iki çağrı gerektirir:

İlk çağrı hiçbir şeyi değiştirmez. Mevcut ayarları okur ve her alan için mevcut ve önerilen değeri içeren bir önizleme ile bir confirmation_token döndürür.
Asistan size önizlemeyi gösterir. Onayladıktan sonra, aracı tam olarak aynı argümanlar ve confirmation_token ile yeniden çağırır. Sunucu bu noktada değişikliği yazar.

confirmation_token çalışan sunucu tarafından üretilir, bir kez kullanılabilir ve 5 dakika sonra sona erer. Araca, tam argümanlara ve önizlenen ayar sürümüne bağlıdır. Farklı argümanlarla kullanılan bir belirteç reddedilir ve tüketilir. Önizlemeden sonra ayarlar değişmişse yazma 412 hatasıyla başarısız olur ve baştan başlamanız gerekir. Sunucu saniyede en fazla 5 yazma yapar.

Silen, iptal eden veya döndüren araçlar, --allow-write ile bile sunulmaz. Her yazma çağrısını MCP istemcinizde onaylayın; istemciyi yazma araçlarını otomatik onaylayacak şekilde ayarlamayın.

Yapılandırma

Değişken	Zorunlu	Açıklama
`KEENAUTH_API_KEY`	evet	Yönetim API anahtarı. Yalnızca okuma kapsamlarına sahip bir anahtar kullanın; `--allow-write` ile yalnızca `environment-settings:write` ekleyin.
`KEENAUTH_BASE_URL`	evet	Ortamınızın yönetim API temel URL'si.

--tools <pattern> araç listesini daraltır; örneğin --tools "users_*". Yalnızca daraltabilir; kapalı bir aracı asla etkinleştirmez ve --allow-write olmadan bir yazma aracını etkinleştiremez.

Asistanın gördükleri

Kişisel veriler maskelenir: e-posta adresleri a***@e***.com biçiminde görünür, telefon numaralarında yalnızca son iki rakam gösterilir, adlarda yalnızca ilk harf gösterilir.
Kuruluşun metadata alanı asla döndürülmez: {"redacted": true} olarak görünür. Üyelikler, kuruluş rolleri, alan adları ve politikalar bu sürümde bir araca sahip değildir.
Ortam ayarları yalnızca belgelenmiş alanları döndürür. Sunucunun daha sonra eklediği bir alan, incelenene kadar gizli kalır.
Gizli değerler asla döndürülmez. Gizli veya özel anahtar gibi görünen alanlar kaldırılır ve yanıt, kaldırılan alan yollarını redacted_fields içinde listeler.
Her araç sonucu untrusted_content içine sarılır. Bu içerikteki adları, meta verileri ve açıklamaları talimat değil, veri olarak değerlendirin.
API anahtarı araç çıktısında, hatalarda veya günlüklerde asla görünmez.

Denetim izi

MCP sunucusunun gönderdiği her istek Idp-Client: keenauth-mcp/<version> ve Idp-Mcp-Tool: <tool name> üstbilgilerini taşır. Bir çağrı bir şeyi değiştirdiğinde, denetim günlüğü girdisi olağan işlemi yapan (API anahtarı veya M2M istemcisi) bilgisinin yanında metadata.client = mcp/<version> ve metadata.mcp_tool = araç adı değerlerini kaydeder. Bu değerleri MCP sunucusu bildirir, doğrulanmaz: Bir asistanın ne yaptığını bulmak için kullanın, sorumluyu belirlemek için ise işlemi yapan bilgisini kullanın.

Araç tanımları sabitlenmiştir

Araç adları, açıklamaları ve girdi şemaları derleme sırasında API açıklamasından üretilir ve her sürüm için sabitlenir. SHA-256 özetleri tools.digest içinde saklanır; herhangi bir araç tanımındaki değişiklik özeti değiştirir ve bir güvenlik incelemesi gerektirir.