Claude Code, Codex ve Cursor

Kodlama asistanını Era'ya MCP ile tarayıcıdan giriş yaparak bağla — kopyalanacak anahtar yok — ve senin izinlerinle okuyup iş yapsın.

Era'nın MCP sunucusu https://app.getera.io/api/mcp adresindedir (streamable HTTP). Asistanına anahtarsız ekle: ilk bağlanışta tarayıcında Era'nın onay kartı açılır; işletmeyi, asistanın ulaşabileceği modülleri ve yalnız okuyup okumayacağını seçersin, asistan da tam olarak buna bağlı bir OAuth token'ı alır. Era'da senin ulaştığından öteye asla geçemez; bağlantıyı istediğin an Ayarlar → Gelişmiş → API anahtarları → Bağlı uygulamalar altından kesebilirsin.

Terminal

claude mcp add --transport http era https://app.getera.io/api/mcp

Sonra Claude Code'un içinde:

Claude Code

/mcp

era → Authenticate'i seç. Tarayıcında Era'nın onay kartı açılır; onayla ve geri dön — durum "bağlı" olur.

Terminal

codex mcp add era --url https://app.getera.io/api/mcp
codex mcp login era

codex mcp login era tarayıcında Era'nın onay kartını açar. Ayar dosyasını tercih edersen aynı sunucu ~/.codex/config.toml içinde şöyle yazılır:

~/.codex/config.toml

[mcp_servers.era]
url = "https://app.getera.io/api/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "era": { "url": "https://app.getera.io/api/mcp" }
  }
}

Cursor sunucuya ilk bağlandığında Era'nın giriş sayfasını açar (Settings → MCP durumunu gösterir).

Kendi kurulumun için yazdır

Komut satırı aracı kuruluysa era mcp bu parçaları kendi Era adresinle yazar (tek biri için era mcp --client claude|codex|cursor).

Asistan neleri alır

Yalnız onayın izin verdiklerini, araç olarak:

Araç	Ne yapar
`read__…`	Okuyabildiği modülleri okur — müşteriler, siparişler, randevular, faturalar… — senin satır kurallarınla ve gizlenen alanlarınla.
`recall_memory`	İşletmenin hafızasında (Brain) arar. Yapay zekâ modülü gerekir.
`era__<modül>__<işlem>`	Çağırabildiği her işlem, ör. `era__crm__capture_lead`, `era__retail__fulfil_order`. API ile aynı girdi, ön koşullar ve hatalar; her biri senin adınla çalışır ve etkinlik akışına düşer.

Dene

İlk istek, yalnız okuma

Era'yı kullanarak gönderilmemiş en yeni 10 siparişimi müşteri, tutar ve ödeme durumuyla listele.
Hiçbir şeyi değiştirme.

İlk yazma

Era'yı kullanarak [email protected] müşterisi için bir potansiyel müşteri kaydı aç — yıllık planı istiyor.
Aracı çağırmadan önce bana göster.

Sorun giderme

Gördüğün	Nedeni ve yapılacak
Tarayıcı hiç açılmıyor	İstemcinin girişini yeniden başlat (`/mcp` → Authenticate, `codex mcp login era`). O tarayıcıda Era'ya giriş yapmış olduğundan emin ol.
Beklediğin bir araç yok	Token o modüle ulaşmıyor ya da rolün izin vermiyor. Uygulamanın bağlantısını kesip daha çok modülle yeniden bağla ya da bir yöneticiye sor.
`order_not_fulfillable` gibi bir kodla `409`	İşlemin bir ön koşulu tutmadı — başvuru her kodu ve anlamını listeler.
Bir süre sonra `401`	Bağlantı iptal edildi ya da işletmedeki yerin kaldırıldı. Yeniden bağlan.

Giriş yerine API anahtarı mı istiyorsun (ortak bir bilgisayar ya da CI için)? Bkz. MCP sunucusu.