Bağlayıcılar CLI Referansı

Katalogdan çalışan bir örneğe giden en kısa yolu istediğinizde chainabit connectors komutunu kullanın.

Kurulum ve Keşif

chainabit connectors list
chainabit connectors list --category productivity
chainabit connectors list --active --locale tr
chainabit connectors get slack
chainabit connectors install slack --name "Team Slack"

connectors list kataloğu gösterir. connectors install, mevcut çalışma alanında bir örnek oluşturur.

connectors list --json komutundan örnek JSON çıktısı:

[
  {
    "key": "slack",
    "displayName": "Slack",
    "category": "communication",
    "authType": "oauth2",
    "supportedFeatures": ["tool_discovery", "health_check"],
    "isActive": true
  }
]

Bir Örneğin Kimliğini Doğrulama

Tarayıcı tabanlı bağlayıcılar varsayılan OAuth akışını kullanır:

chainabit connectors auth inst_123

Bu yol etkileşimlidir. CI veya diğer etkileşimsiz işlerde, bağlayıcı destekliyorsa bir yazılı kimlik bilgisi işareti kullanın.

Bağlayıcınız bir API anahtarı, bearer token, bağlantı dizesi, temel kimlik doğrulaması veya özel kimlik bilgisi yükü kullanıyorsa, bunun yerine ilgili işareti iletin:

chainabit connectors auth inst_123 --api-key-env SLACK_API_KEY
chainabit connectors auth inst_123 --token-file ./.secrets/github-token.txt
chainabit connectors auth inst_123 --connection-string-env ANALYTICS_DB_URL
chainabit connectors auth inst_123 --username api-user --password-env CONNECTOR_PASSWORD
chainabit connectors auth inst_123 --custom-file ./.secrets/custom-credentials.json

Bir tarayıcıyı otomatik olarak başlatmak yerine OAuth URL'sini manuel olarak kopyalamak istiyorsanız --no-open parametresini kullanın.

Mümkün olduğunda bağlayıcı sırlarını komut satırında doğrudan iletmekten kaçının. Env (Çevre Değişkeni), stdin ve dosya tabanlı girdiler, kabuk geçmişinde ve işlem listelerinde açığa çıkmayı azaltır.

Çalışma Zamanı Durumunu İnceleme

chainabit connectors instances list
chainabit connectors instances get inst_123
chainabit connectors instances update inst_123 --name "Team Slack" --enabled
chainabit connectors test inst_123
chainabit connectors tools inst_123 --locale tr
chainabit connectors executions inst_123 --limit 10

connectors tools, yürütebileceğiniz araç kimliklerini gösterir. connectors executions, bir örneğin son araç çalıştırma geçmişini gösterir.

Bir Aracı Çalıştırma

chainabit connectors exec inst_123 send_message \
  --input '{"channel":"#general","text":"Hello from Chainabit!"}'

connectors exec, araç anahtarını veya connectors tools tarafından gösterilen araç kimliğini kabul eder.

Dinamik Bağlayıcıları Senkronize Etme

chainabit connectors sync inst_123

Dinamik bir MCP tarzı bağlayıcıya bağlandıktan sonra sync komutunu kullanın, böylece CLI ve API araç listesini yenileyebilir.

JSON Komut Dosyası

chainabit connectors list --json | jq '.[0].key'
chainabit connectors tools inst_123 --json
chainabit connectors executions inst_123 --json

Önerilen İş Akışı

1. chainabit connectors list
2. chainabit connectors install <key>
3. chainabit connectors auth <instance-id>
4. chainabit connectors test <instance-id>
5. chainabit connectors tools <instance-id>
6. chainabit connectors exec <instance-id> <tool> --input '<json>'

İlgili API Sözleşmeleri

• install, instances ve test komutlarının arkasındaki istek ve yanıt DTO'ları için Bağlayıcı Örnekleri API'sini (EN) kullanın.
• tools ve sync tarafından döndürülen şemalar için Bağlayıcı Araçları API'sini (EN) kullanın.
• connectors exec komutunun arkasındaki girdi ve çıktı sözleşmesi için Araç Çalıştırma API'sini (EN) kullanın.