Connect Profound CMS to your AI client

Profound CMS, uyumlu yapay zekâ istemcilerinin CMS içeriğini keşfetmesine, oluşturmasına, güncellemesine, yayımlamasına ve yönetmesine olanak tanıyan uzak bir MCP sunucusu sağlar.

MCP uç noktası:

http://107.21.107.99:8081/mcp

Üretim ortamında, kullanılabilir olduğunda yapılandırılmış MCP URL'nizin HTTPS sürümünü kullanın.

Kimlik doğrulama

Profound CMS MCP, WorkOS OAuth kullanır.

Bağlanmak için:

1. Bir Profound CMS hesabı oluşturun.
2. Hesabınızın doğru kuruluşa ait olduğunu doğrulayın.
3. MCP sunucusunu yapay zekâ istemcinize ekleyin.
4. İstendiğinde tarayıcı tabanlı oturum açma işlemini tamamlayın.

Yapay zekâ istemcinize bir API anahtarı kopyalamanız gerekmez. Oturum açtıktan sonra istemci, kısa ömürlü bir erişim belirteci alır ve bunu otomatik olarak yeniler.

CMS rolünüz erişimi kontrol eder:

• Üyeler CMS içeriğini okuyabilir.
• Editörler ve yöneticiler içerik oluşturabilir, güncelleyebilir ve yayımlayabilir.

Claude Code

Şunu çalıştırın:

claude mcp add --transport http Profound http://107.21.107.99:8081/mcp

Ardından Claude Code'u başlatın ve tarayıcı üzerinden kimlik doğrulama akışını tamamlayın.

Bağlantıyı doğrulayın:

claude mcp list

Codex CLI

Şunu çalıştırın:

codex mcp add Profound --url http://107.21.107.99:8081/mcp

Codex, sunucu ilk kez kullanıldığında kimlik doğrulaması isteyecektir.

Bağlantıyı şu komutla doğrulayabilirsiniz:

codex mcp list

OpenCode

Aşağıdakini şu dosyaya ekleyin:

~/.config/opencode/opencode.json

{
  "mcp": {
    "profound": {
      "type": "remote",
      "url": "http://107.21.107.99:8081/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}

Ardından kimlik doğrulaması yapın:

opencode mcp auth profound

Bağlantıyı doğrulayın:

opencode mcp list

Sunucu, OAuth üzerinden bağlı olarak görünmelidir.

Cursor, Windsurf ve diğer MCP istemcileri

MCP uyumlu istemcilerin çoğu standart uzak HTTP yapılandırmasını destekler:

{
  "mcpServers": {
    "profound": {
      "url": "http://107.21.107.99:8081/mcp"
    }
  }
}

Cursor, Windsurf, Claude Desktop veya başka bir MCP istemcisinde:

1. MCP ya da entegrasyon ayarlarını açın.
2. Uzak bir HTTP MCP sunucusu ekleyin.
3. Profound MCP URL'sini kullanın.
4. İstemci bir OAuth seçeneği sunuyorsa OAuth kimlik doğrulamasını etkinleştirin.
5. Tarayıcınızda Profound CMS oturum açma işlemini tamamlayın.

İstemcinin Streamable HTTP MCP ve OAuth'u desteklemesi gerekir. Yalnızca yerel sunucuları veya statik API anahtarlarını destekleyen istemciler bu sunucuyla doğrudan kimlik doğrulaması yapamaz.

Her oturuma keşifle başlayın

Bağlandıktan sonra yapay zekâ istemcinizden kullanabileceğiniz kuruluşları ve web sitelerini keşfetmesini isteyin:

Yalnızca Profound MCP sunucusunu kullanın.

Önce list_my_organizations çağrısını yapın.
Ardından list_organizations çağrısını yapın.
list_organizations tarafından döndürülen kuruluş kimliğini kullanarak list_websites çağrısını yapın.

Kuruluş adlarını, web sitesi adlarını ve web sitesi kimliklerini bir tabloda gösterin.

Tüm CMS işlemleri bir website_id gerektirir.

Kullanılabilir araçlar

MCP sunucusu şu anda 35 CMS aracı sağlar.

Kuruluşlar ve web siteleri

• list_my_organizations
• list_organizations
• list_websites

Sayfalar

• create_page
• update_page
• delete_page
• get_page
• list_pages

Rota bağlamaları

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Rota bağlamaları, şablon sayfalarını belirli içeriklere veya parametre değerlerine bağlar.

Bileşenler

• create_component
• update_component
• delete_component
• list_components

Bileşenler, yeniden kullanılabilir içerik türlerini ve bunların alanlarını tanımlar.

Bloklar

• create_block
• update_block
• delete_block
• get_block
• list_blocks
• publish_block

Bloklar, sayfalara yerleştirilen içerik örnekleridir.

Dinamik alanlar ve Template Builder ifadeleri

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Bu araçlar, oluşturma zamanında alan değerlerini hesaplayan dinamik fx ifadelerini yönetir.

Belgeler ve varyantlar

• create_document
• update_document
• delete_document
• get_document
• list_documents

Belgeler, varyant olarak da adlandırılan yeniden kullanılabilir içerik girdileridir. list_documents meta verileri döndürür; tam içeriği almak için get_document kullanın.

Çeviriler

• list_document_translations
• upsert_document_translation
• delete_document_translation

Çeviriler, her dil için ayrı bir belge oluşturmak yerine tek bir belgede yerel ayar satırları olarak saklanmalıdır.

Tipik CMS iş akışı

Eksiksiz bir içerik iş akışı genellikle şu şekilde görünür:

1. Kuruluşları ve web sitelerini keşfedin.
2. Mevcut bileşenleri, sayfaları, blokları ve belgeleri inceleyin.
3. Gerekli içeriği oluşturun veya güncelleyin.
4. Blokları, bileşenleri veya belgeleri güncellerken expected_version kullanın.
5. Blokları veya belgeleri yayımlayın.
6. Sayfa durumunu Live olarak ayarlayın.
7. Yayımlanan içeriği doğrulayın.

Bir sayfa yalnızca canlı olduğunda ve içeriği yayımlandığında herkese açık olarak görünür.

Örnek istemler

Bir sayfa oluşturun:

Profound CMS kullanarak <website_id> web sitesi için /pricing adresinde bir sayfa oluşturun.
Gerekli blokları oluşturun, yayımlayın ve sayfayı Live olarak ayarlayın.

Mevcut içeriği güncelleyin:

<website_id> web sitesinin ana sayfasını bulun.
Mevcut bloklarını okuyun, hero başlığını güncelleyin ve değişikliği yayımlayın.

Yerelleştirilmiş içerik oluşturun:

<document_id> belgesine Fransızca ve Almanca çeviriler ekleyin.
Mevcut belgeyi kullanın ve yinelenen belgeler oluşturmak yerine çeviri satırları oluşturun.

Dinamik içerik kullanın:

Şablon sayfasındaki hero bloğunda, başlığın rota bağlamalı belgeden alınmasını sağlayın.
Formülü draft_content içine yerleştirmek yerine bir blok alanı ifadesi kullanın.

Uçtan uca içerik iş akışı

Profound CMS MCP, eksiksiz bir iş akışını desteklemek için diğer MCP sunucularıyla birleştirilebilir:

Örneğin:

Figma MCP + Profound CMS MCP

tasarım keşfini, içerik oluşturmayı, CMS yazarlığını, yerelleştirmeyi ve yayımlamayı tek bir yapay zekâ destekli iş akışında birleştirebilir.