Connect Profound CMS to your AI client

Profound CMS menyediakan server MCP jarak jauh yang memungkinkan klien AI kompatibel untuk menemukan, membuat, memperbarui, menerbitkan, dan mengelola konten CMS.

Endpoint MCP:

http://107.21.107.99:8081/mcp

Untuk produksi, gunakan versi HTTPS dari URL MCP yang telah dikonfigurasi jika tersedia.

Autentikasi

Profound CMS MCP menggunakan OAuth WorkOS.

Untuk terhubung:

1. Buat akun Profound CMS.
2. Pastikan akun Anda termasuk dalam organisasi yang benar.
3. Tambahkan server MCP ke klien AI Anda.
4. Selesaikan login berbasis browser saat diminta.

Anda tidak perlu menyalin kunci API ke klien AI Anda. Setelah login, klien menerima token akses berumur pendek dan memperbaruinya secara otomatis.

Peran CMS Anda mengontrol akses:

• Anggota dapat membaca konten CMS.
• Editor dan administrator dapat membuat, memperbarui, dan menerbitkan konten.

Claude Code

Jalankan:

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

Kemudian mulai Claude Code dan selesaikan alur autentikasi melalui browser.

Verifikasi koneksi:

claude mcp list

Codex CLI

Jalankan:

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

Codex akan meminta autentikasi saat server pertama kali digunakan.

Anda dapat memverifikasi koneksi dengan:

codex mcp list

OpenCode

Tambahkan konfigurasi berikut ke:

~/.config/opencode/opencode.json

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

Kemudian lakukan autentikasi:

opencode mcp auth profound

Verifikasi koneksi:

opencode mcp list

Server akan muncul sebagai terhubung melalui OAuth.

Cursor, Windsurf, dan klien MCP lainnya

Sebagian besar klien yang kompatibel dengan MCP mendukung konfigurasi HTTP jarak jauh standar:

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

Di Cursor, Windsurf, Claude Desktop, atau klien MCP lainnya:

1. Buka pengaturan MCP atau integrasi.
2. Tambahkan server MCP HTTP jarak jauh.
3. Gunakan URL MCP Profound.
4. Aktifkan autentikasi OAuth jika klien menyediakan opsi OAuth.
5. Selesaikan login Profound CMS di browser Anda.

Klien harus mendukung Streamable HTTP MCP dan OAuth. Klien yang hanya mendukung server lokal atau kunci API statis tidak dapat melakukan autentikasi langsung dengan server ini.

Mulai setiap sesi dengan discovery

Setelah terhubung, minta klien AI Anda untuk menemukan organisasi dan situs web yang tersedia bagi Anda:

Gunakan server Profound MCP saja.

Pertama, panggil list_my_organizations.
Kemudian panggil list_organizations.
Gunakan ID organisasi yang dikembalikan oleh list_organizations untuk memanggil list_websites.

Tampilkan nama organisasi, nama situs web, dan ID situs web dalam tabel.

Semua operasi CMS memerlukan website_id.

Alat yang tersedia

Server MCP saat ini menyediakan 35 alat CMS.

Organisasi dan situs web

• list_my_organizations
• list_organizations
• list_websites

Halaman

• create_page
• update_page
• delete_page
• get_page
• list_pages

Pengikatan rute

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Pengikatan rute menghubungkan halaman templat ke konten atau nilai parameter tertentu.

Komponen

• create_component
• update_component
• delete_component
• list_components

Komponen menentukan jenis konten yang dapat digunakan kembali beserta field-nya.

Blok

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

Blok adalah instans konten yang ditempatkan pada halaman.

Field dinamis dan ekspresi Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Alat-alat ini mengelola ekspresi fx dinamis yang menghitung nilai field saat rendering.

Dokumen dan varian

• create_document
• update_document
• delete_document
• get_document
• list_documents

Dokumen adalah entri konten yang dapat digunakan kembali, yang juga disebut varian. list_documents mengembalikan metadata; gunakan get_document untuk mengambil konten lengkap.

Terjemahan

• list_document_translations
• upsert_document_translation
• delete_document_translation

Terjemahan sebaiknya disimpan sebagai baris locale dalam satu dokumen, bukan dengan membuat dokumen terpisah untuk setiap bahasa.

Alur kerja CMS yang umum

Alur kerja konten lengkap biasanya terlihat seperti berikut:

1. Temukan organisasi dan situs web.
2. Periksa komponen, halaman, blok, dan dokumen yang sudah ada.
3. Buat atau perbarui konten yang diperlukan.
4. Gunakan expected_version saat memperbarui blok, komponen, atau dokumen.
5. Terbitkan blok atau dokumen.
6. Atur status halaman menjadi Live.
7. Verifikasi konten yang telah diterbitkan.

Halaman hanya terlihat oleh publik jika halaman tersebut berstatus live dan kontennya telah diterbitkan.

Contoh prompt

Membuat halaman:

Dengan menggunakan Profound CMS, buat halaman di /pricing untuk situs web <website_id>.
Buat blok yang diperlukan, terbitkan blok tersebut, dan atur halaman menjadi Live.

Memperbarui konten yang sudah ada:

Temukan beranda untuk situs web <website_id>.
Baca bloknya saat ini, perbarui judul utama hero, lalu terbitkan perubahan tersebut.

Membuat konten terlokalisasi:

Untuk dokumen <document_id>, tambahkan terjemahan bahasa Prancis dan Jerman.
Gunakan dokumen yang sudah ada dan buat baris terjemahan, bukan dokumen duplikat.

Menggunakan konten dinamis:

Untuk blok hero pada halaman templat, buat judul utama mengambil data dari dokumen yang terikat pada rute.
Gunakan ekspresi field blok, bukan menempatkan formula di draft_content.

Alur kerja konten menyeluruh

Profound CMS MCP dapat digabungkan dengan server MCP lainnya untuk mendukung alur kerja yang lengkap:

Sebagai contoh:

Figma MCP + Profound CMS MCP

dapat menghubungkan penemuan desain, pembuatan konten, penulisan CMS, pelokalan, dan penerbitan ke dalam satu alur kerja berbantuan AI.