XPlanner

Docs

MCP

XPlanner MCP bağlantısını Claude, ChatGPT, Codex CLI ve Claude Code CLI ile kurma rehberi.


Genel Bakış

MCP bağlantısı ne işe yarar?

XPlanner MCP sunucusu, desteklenen istemcilerin çalışma alanı ve içerik akışıyla güvenli şekilde konuşmasını sağlar.

  1. MCP sayfasından Claude veya Codex / ChatGPT istemcisini seç.

  2. Bağlan aksiyonuyla istemcinin bağlantı ekranını aç.

  3. Gerekirse MCP endpoint veya CLI komutunu drawer içinden kopyala.

  4. Bağlantı sırasında XPlanner hesabınla OAuth onayı ver.

MCP ekranını aç

Claude, ChatGPT ve CLI bağlantı bilgilerini görüntüle.

Yetenekler

MCP hangi XPlanner işlemlerini yapabilir?

Bağlanan Claude, ChatGPT veya Codex istemcisi yalnız onayladığın scope'larla çalışır; araçlar güncel Public API sözleşmesini kullanır.

  1. Çalışma alanlarını, Sosyal Setleri ve X, LinkedIn, Threads yayın hedeflerini keşfedebilir.

  2. Platformların güncel metin ve medya sınırlarını okuyup hedefe özel publishTargets hazırlayabilir.

  3. Gönderi, fikir, klasör ve medya akışlarında okuma, oluşturma, güncelleme ve izin verilirse silme işlemleri yapabilir.

  4. Yayınlama ve silme gibi riskli aksiyonlarda ayrıca açık onay ve ilgili ince scope gerekir.

Rutinler henüz Public API ve MCP yüzeyine açılmaz; kullanıcı sahipliği ve ayrı izin alanı tamamlanmadan otomatik çalışma akışı dışarı sunulmaz.

Claude’a Bağlanma

Claude bağlantısını kur

Claude için XPlanner bağlantısı, Claude’un connector ekranına hazır bağlantı bilgisiyle yönlenir.

  1. Hesap Ayarları > MCP ekranını aç.

  2. Claude kartındaki Bağlan aksiyonunu seç.

  3. Claude bağlantı ekranında MCP sunucu adını ve endpoint değerini kontrol et.

  4. Claude içinde bağlantıyı onayla.

Claude bağlantı ekranı desteklediği bilgileri otomatik doldurur; eksik alan olursa MCP drawer’daki endpoint değerini kopyalayabilirsin.

ChatGPT / Codex’e Bağlanma

ChatGPT ve Codex bağlantısını kur

ChatGPT Connector ekranında XPlanner MCP endpoint değerini kullanarak bağlantıyı oluşturabilirsin.

  1. Hesap Ayarları > MCP ekranında Codex kartındaki Bağlan aksiyonunu seç.

  2. ChatGPT connector ekranı açıldığında connector adını xplanner olarak belirle.

  3. MCP endpoint alanına https://mcp.xplanner.co/mcp değerini gir.

  4. Bağlantı sırasında XPlanner OAuth onayını tamamla.

Connector adı ve endpoint için resmi otomatik doldurma parametresi desteklenmiyorsa XPlanner undocumented URL parametresi kullanmaz.

Codex CLI

Codex CLI ile bağlan

Terminalden çalışıyorsan XPlanner MCP sunucusunu Codex CLI ile ekleyebilirsin.

  1. Codex CLI kurulu ve giriş yapılmış olmalı.

  2. MCP drawer içindeki komutu kopyala.

  3. Terminalde codex mcp add xplanner --url https://mcp.xplanner.co/mcp komutunu çalıştır.

  4. Codex OAuth onayı isterse tarayıcı akışını tamamla.

Claude Code CLI

Claude Code CLI ile bağlan

Claude Code CLI kullanıyorsan XPlanner MCP sunucusunu terminalden ekleyebilirsin.

  1. Claude Code CLI kurulu ve giriş yapılmış olmalı.

  2. MCP drawer içindeki komutu kopyala.

  3. Terminalde claude mcp add --transport http xplanner https://mcp.xplanner.co/mcp komutunu çalıştır.

  4. Claude OAuth onayı isterse bağlantı akışını tamamla.

Gelişmiş Kurulum

Manuel config ne zaman gerekir?

CLI komutları çoğu kullanıcı için yeterlidir. Manuel config yalnızca özel kurulumlarda veya proje bazlı MCP ayarı gerektiğinde tercih edilmelidir.

  1. ~/.codex/config.toml yerel Codex kullanıcı yapılandırmasıdır.

  2. Project-level .codex/config.toml yalnızca ilgili proje çalışma alanı için geçerli ayarları taşır.

  3. Manuel config yönteminde sunucu adı xplanner, endpoint ise https://mcp.xplanner.co/mcp olmalıdır.

  4. CLI yöntemi aynı yapılandırmayı daha az hata riskiyle oluşturduğu için varsayılan öneridir.

Manuel yapılandırma normal kullanıcı için zorunlu değildir; MCP drawer’da bu yüzden hazır CLI komutu gösterilir.

Sorun Giderme

Bağlantı çalışmazsa neyi kontrol etmeliyim?

MCP bağlantısı istemci, OAuth ve XPlanner hesabı arasında kurulur. Sorun yaşarsan önce temel bağlantı bilgilerini doğrula.

  1. Endpoint değerinin https://mcp.xplanner.co/mcp olduğunu kontrol et.

  2. XPlanner hesabında oturum açtığından emin ol.

  3. OAuth onay penceresi açılmıyorsa tarayıcı popup engelini kontrol et.

  4. CLI kullanıyorsan istemcinin güncel sürümde olduğundan emin ol.

Kılavuz nasıl güncellenecek?

Yeni bir kullanıcı akışı çıktığında bu bölüm aynı docs yapısına yeni sayfa olarak eklenir.

Ekran dili değiştiğinde Playwright smoke ile gerçek buton ve başlık adları tekrar kontrol edilir.

API ile ilişkili akışlarda ilgili API v1 sayfasına çapraz bağlantı eklenir.