Kamai MCP

npx add-mcp 'https://mcp.kamai.io/mcp'

kamai-mcp

Kamai'nin MCP sunucusu: Kamai inşaat-blueprint projeleri, blueprint'ler ve takeoff'lar için araçlar ve MCP Apps widget'ları. Kamai'nin MCP API'si üzerinden çalışır ve Kamai'nin OAuth yetkilendirme sunucusu tarafından verilen erişim token'larını doğrular. Kamai sırlarını barındırmaz.

Araçlar

Araç	Ne yapar
view_projects	Kullanıcının projelerinin ve blueprint'lerinin etkileşimli paneli
list_blueprints	Projelere göre gruplandırılmış blueprint'ler, kimlikleri ve hazır olup olmadıklarıyla birlikte
view_blueprint	Üzerine take-off şekilleri çizilmiş bir blueprint sayfası
view_takeoff	Ölçülen take-off miktarları sıralanabilir bir tablo olarak
list_elements	Ana hatlarıyla birlikte öğe başına satırlar (odalar, duvarlar, kapılar, pencereler, nesneler)
list_folders	Bir blueprint'in lejant klasörleri
download_plan	Tespit edilen öğeleri vurgulanmış işlenmiş bir blueprint'in PDF'i, geçici bir indirme bağlantısı olarak
update_elements, move_elements, create_folder	Öğeleri yeniden adlandır, yeniden renklendir ve yeniden dosyala; bir klasör oluştur
set_opening_height	Duvar yüzeyi açıklık parçalarına kullanıcı tarafından belirtilen bir yükseklik veya bir kapı/pencere etiketi sakla
create_project, update_project	Bir proje oluştur veya yeniden adlandır
list_jobs, get_job, cancel_job	Bir projenin işleme işleri
view_upload	Bir blueprint PDF'i için yükleme paneli
ingest_blueprint_from_chat	Bir ChatGPT mesajına eklenmiş bir PDF'i içe aktar (yalnızca ChatGPT)
open_kamai	Kamai uygulamasını bir panelde aç

KAMAI_QUERY_TOOLS=on ile (aşağıya bakın):

Araç	Ne yapar
count_elements	Kamai kategorisine göre sayılar ve toplamlar (kapılar, pencereler, duvarlar, ıslak odalar…), gruplandırılmış, veritabanında toplanmış
find_elements	Tür, klasör, etiket, yön ve ölçümlerle bireysel öğeler
calculate_wall_surface_area	Odaların net duvar (boya veya sıva) alanı
render_table	Satırları plan üzerindeki öğelerini vurgulayan bir tablo paneli
set_scale	Bir blueprint'in çizim ölçeğini ayarla

list_blueprints ayrıca include_inventory alır (bir project_id ile): her blueprint'in ne içerdiği.

list_projects, get_project, get_blueprint, request_blueprint_upload, finalize_blueprint_upload ve sorgu araçları get_table_row_elements ve get_element_outlines ile birlikte yalnızca uygulamaya özeldir: widget'lar tarafından çağrılabilir, modele tanıtılmaz.

API anahtarınızla yerel olarak çalıştırın

Bu sunucuyu kendi Kamai verilerinize karşı çalıştırmanın en hızlı yolu yerel moddur: ana bilgisayar sunucuyu başlatır, stdio üzerinden konuşur ve kimlik bilgisi OAuth yerine Kamai'den (Kamai uygulamasında API Anahtarları) kişisel bir API anahtarıdır.

bun install
bun run build:widgets
KAMAI_API_KEY=... MCP_API_BASE_URL=https://mcp-api.kamai.io bun run local

Claude Code:

claude mcp add --env KAMAI_API_KEY=... --env MCP_API_BASE_URL=https://mcp-api.kamai.io \
  --transport stdio kamai -- bun /path/to/kamai-mcp/src/local.ts

Claude Desktop (claude_desktop_config.json):

{ "mcpServers": { "kamai": {
    "command": "bun", "args": ["/path/to/kamai-mcp/src/local.ts"],
    "env": { "KAMAI_API_KEY": "...", "MCP_API_BASE_URL": "https://mcp-api.kamai.io" } } } }

Anahtar, her API çağrısı için taşıyıcı olarak kullanılır; araçlar anahtarın sahibi olarak çalışır. Sorgu araçları için ortama KAMAI_QUERY_TOOLS=on ekleyin.

HTTP sunucusunu çalıştırın

bun install
cp .env.example .env
bun run dev

.env.example içindeki değerler yer tutuculardır: başlamadan önce MCP_PUBLIC_URL ve MCP_AUTH_ISSUER değerlerini tünelinize ve erişilebilir bir yetkilendirme sunucusuna ayarlayın, aksi takdirde her istek invalid_token ile reddedilir.

Değişken	Anlamı
PORT	Dinleme portu, varsayılan 8006
MCP_PUBLIC_URL	Ana bilgisayarların çağırdığı ve token istediği URL (keşifteki resource); bir tünel, localhost değil
MCP_AUTH_ISSUER	Erişim token'larının veren kuruluşu, token'ın iss ile bayt bayt eşleştirilir
MCP_AUTH_JWKS_URI	İsteğe bağlı. Varsayılan {MCP_AUTH_ISSUER}/jwks.json
MCP_API_BASE_URL	Kamai MCP API temel URL'si, https://mcp-api.kamai.io. Ayrıca bir erişim token'ının taşıması gereken hedef kitle
MCP_ACCEPTED_AUDIENCES	İsteğe bağlı virgülle ayrılmış hedef kitleler, bir geçiş için. Varsayılan MCP_API_BASE_URL
KAMAI_API_KEY	Yalnızca yerel mod: araçların çalıştığı kişisel API anahtarı
KAMAI_APP_ORIGINS	İsteğe bağlı virgülle ayrılmış ekstra kaynaklar open_kamai çerçeveleyebilir; ilki varsayılan olur
KAMAI_QUERY_TOOLS	on sorgu araçlarını kaydeder. https://mcp-api.kamai.io onları sunar; /v1/vocabulary ile 404 yanıtı veren bir API'ye karşı kapalı bırakın
KAMAI_MCP_NO_INSTRUCTIONS	1 sunucu talimatlarını claude.ai'nin yaptığı gibi dışarıda bırakır, araç açıklamalarını kendi başlarına test etmek için

MCP API ve yetkilendirme sunucusu Kamai tarafından işletilir, bu nedenle HTTP sunucusunu uçtan uca çalıştırmak her ikisine de erişim gerektirir. Bir MCP sunucusu yalnızca gerçek bir ana bilgisayara karşı test edilebilir ve bir ana bilgisayar yalnızca genel bir HTTPS URL'sine ulaşabilir, bu nedenle HTTP modu geliştirme, bir tünelin arkasında çalışmak ve MCP_PUBLIC_URL değerini ona yönlendirmek anlamına gelir.

bun run dev önce widget'ları oluşturur: sunucu, oluşturulan HTML'i dist/widgets/ konumundan sunar, React kaynağından değil, bu nedenle src/widgets/app/ altındaki herhangi bir şeye dokunduktan sonra yeniden oluşturun.

Widget'lar React, TypeScript, Vite, Tailwind CSS, DaisyUI ve Lucide kullanır. Vite, widget başına kendi kendine yeten bir HTML kaynağı üretir, bu nedenle hiçbir şeyin barındırılması gerekmez.

Yerel derlemeler Bun 1.3.3 ve Node.js 22.12 veya daha yenisini gerektirir.

Düzen

src/index.ts       HTTP sunucusu, OAuth korumalı kaynak meta verileri, MCP taşıma
src/local.ts       Yerel mod için stdio giriş noktası (kişisel API anahtarı)
src/auth.ts        Taşıyıcı token doğrulaması (RFC 9728 zorlukları)
src/server.ts      Araç ve kaynak kaydı
src/api.ts         Kamai MCP API için istemci
src/elements.ts    list_elements sayfalama, filtreleme ve sonuç bütçeleme
src/errors.ts      Başarısız bir araç çağrısının modele gösterdiği metin
src/query/         Sorgu araçları: açıklamalar, kelime dağarcığı, filtreler, bütçeler, sözleşme
src/widgets/       Widget kaynakları, CSP meta verileri ve React widget kaynakları
scripts/           Widget derlemesi (& işaretlerini kaçırır, böylece Open WebUI widget'ları
                   göme bilir); canlı bir API'ye karşı check-routes ve check-vocabulary
scripts/open-webui/
                   Open WebUI yardımcıları: bir open_kamai Aracı, bir görüntüleme modu
                   ana bilgisayar betiği, yerel bir köprü demosu

Gizlilik ve destek

• Gizlilik politikası: https://kamai.io/privacy-policy
• Destek: https://kamai.io/support veya contact@kamai.io

Katkıda bulunma

Bkz. CONTRIBUTING.md. Güvenlik sorunları SECURITY.md içindeki adrese gider, sorun izleyiciye değil.

Lisans

Apache-2.0. Telif Hakkı 2026 Kamai Enterprises LTD.

Kamai adı ve logosu Kamai Enterprises LTD'nin ticari markalarıdır ve lisans kapsamında değildir.