Tek ağ geçidi

Era'nın kullanabildiği her uygulama tek bir ağ geçidinden geçer. Aracı nereden çağırdığın fark etmez: masaüstü sohbetinde, bir iş akışı adımında, SDK'da ya da bir MCP istemcisinde aynı bağlantı, aynı izin kontrolü ve aynı hata mesajları geçerlidir.

Era bir uygulamaya üç yoldan ulaşır

Bir uygulamaya birden fazla yoldan ulaşılabiliyorsa bile Uygulamalar (/apps) sayfasında tek bir kayıt olarak görünür. Sayfanın üstündeki sayılar toplamları gösterir: uygulama, eylem (araç), tetikleyici ve senin bağladıkların.

Kim neyi çalıştırabilir

Her araç için aynı kural geçerlidir:

1. Her uygulama bir Era modülüne karşılık gelir.

   • CRM'ler → Satış
   • Ödeme ve muhasebe uygulamaları → Finans
   • İnsan kaynakları uygulamaları → Çalışanlar
   • Destek masaları ve müşteri mesajlaşması → Gelen kutusu
   • E-posta pazarlama ve sosyal medya araçları → Kampanyalar
   • Veritabanları → Veri
   • Analitik → Raporlar
   • Diğerleri (belgeler, geliştirici araçları, arama…) → Uygulamalar
   • O modül çalışma alanında kapalıysa uygulama Uygulamalar altında sayılır.

2. Yalnızca okuyan bir adım o modülde görüntüleme yetkisi ister. Bir şeyi değiştiren adım düzenleme yetkisi ister. Bir adım şu durumlarda okuyan sayılır:

   • bir GET isteğiyse, ya da
   • adı bir okuma bildiriyorsa (get, list, search…) ve değiştiren bir fiil içermiyorsa.

   Bunların dışındaki her adım değiştiren sayılır.

3. "Kişi" adımın nerede çalıştığına göre belirlenir:

   • Uygulama ya da masaüstü: oturum açmış üye.
   • İş akışı: Kim olarak çalışır kişisi (tetikleyiciyi yayına alan, yoksa sahibi). Asla bir sistem kullanıcısı değildir.
   • API anahtarı ya da OAuth jetonu: anahtarın kapsamı ∩ üyenin o anki yetkisi.

4. Hangi bağlantının kullanılacağı: o kişinin kullanabildiği, o uygulamaya ait bir bağlantı — kendi bağlantısı, onunla paylaşılan ya da şirketinki.

   • Era başka bir uygulamaya asla geçmez.
   • Bağlı bir hesap yoksa çağrı "Uygulama bağlı değil" hatasıyla durur.

Örnek: bir satış üyesi HubSpot'u şirketin paylaştığı bağlantıyla kullanabilir. Aynı yolla Stripe ödemelerini okuyamaz, çünkü Stripe Finans yetkisi ister.

Tetikleyiciler

Bir uygulamanın tetikleyicileri iş akışında başlangıç bloğu olarak görünür. İki türü vardır:

• Anında (webhook): uygulama Era'yı çağırır. Uygulama gönderimlerini imzalıyorsa Era, iş akışını başlatmadan önce imzayı senin girdiğin gizli anahtarla doğrular.
• Zamanlanmış kontrol (polling): Era uygulamayı makul aralıklarla yoklar; örneğin RSS, Gmail, Outlook ve IMAP.

Koddan kullanmak

import { createEra } from '@getera/sdk'
const era = createEra({ apiKey: process.env.ERA_API_KEY })

const { data, coverage } = await era.apps.list({ q: 'crm' })        // katalog
const tools = await era.apps.tools('hubspot')                       // araçlar + argüman şemaları
await era.apps.hubspot.hubspot_get_contacts({ limit: 10 })          // adıyla tek bir araç
await era.apps.call('wikipedia', 'wikipedia_search', { query: 'İstanbul' })

HTTP uç noktaları:

• GET /api/v1/apps uygulamaları listeler.
• GET /api/v1/apps/{app} tek bir uygulamayı araçları ve tetikleyicileriyle döndürür.
• GET /api/v1/apps/{app}/tools uygulamanın araçlarını listeler.
• POST /api/v1/apps/{app}/tools/{tool} bir aracı çalıştırır. Gövde: { "arguments": { … }, "connection": "auto" | "mine" | "workspace" | "<id>" }.

MCP'de (Claude Code, Codex, Cursor) ağ geçidi binlerce araç yerine üç araçtır:

• apps__search bir uygulama bulur.
• apps__tools uygulamanın araçlarını listeler.
• apps__call bir aracı çalıştırır.

İş akışında Era bağlı uygulama adımını kullan (uygulamayı seç, aracın adını yaz, argümanları ver) ya da uygulamanın kendi bloğunu kullan.

Composio ya da Pipedream ile daha fazla uygulama (isteğe bağlı)

Era'da yerleşik olmayan uygulamalar için bir sahip Uygulamalar → Gizli anahtarlar altına sağlayıcı anahtarı ekleyebilir:

• Composio: COMPOSIO_API_KEY
• Pipedream Connect: PIPEDREAM_CLIENT_ID, PIPEDREAM_CLIENT_SECRET ve PIPEDREAM_PROJECT_ID. İstersen PIPEDREAM_ENVIRONMENT da eklenir.

Bu uygulamalar, bir uygulama kimliğinin geçtiği her yerde composio:<toolkit> ya da pipedream:<app> olarak yazılır. Arama şöyle yapılır: GET /api/v1/apps?provider=composio&q=….

Bu uygulamalar da diğerleriyle aynı izin kuralına uyar. Her üye sağlayıcıda kendi hesabını bağlar; şirket hesabını yalnızca bir yönetici ekleyebilir.

Bu özellik varsayılan olarak kapalıdır: Era hiçbir sağlayıcı anahtarıyla gelmez.