Senin ritmin.
Senin kurduğun bağlantılar.

01 / VERİLERİNE YENİ BAĞLANTILAR

Küçük bir bağlantı.
Fikirlerine kocaman bir alan.

Eşitlenmiş ajandanı oku, kendi iş akışlarını oluştur veya MCP üzerinden bir asistan bağla. Kişisel token’lar her bağlantıya hesabın için salt okuma ya da okuma-yazma yetkisi verir.

02 / İLK BAĞLANTINI KUR

Tek token.
Dünyana yeni bir bağlantı.

1. Hesabını bağla ve eşitle.

   Uygulamayı aç: Solsty ve bir hesap bağla. API ve MCP yalnızca o hesaba eşitlenen verilere erişir; tarayıcıda kalan veriler yerel kalır.

2. Kişisel token oluştur.

   Şu bölümü aç: Ayarlar → API & MCP → Token yönetimi. Bağlantıya isim ver. Yetki seç: Salt okuma veya Okuma ve yazma, ardından süreyi belirle ve şu düğmeye bas: Token oluştur.

3. Bir kez kopyala. Güvenle bağlan.

   Token’ın tamamı yalnızca bir kez gösterilir. Güvenli bir yerde sakla ve şu başlıkla gönder: Authorization: Bearer YOUR_TOKEN. Verilerini keşfetmek için salt okuma token’ıyla şu uç noktayı kullan: GET /resources ve yanıtı incele.

# Create a token in Settings > API & MCP > Manage tokens.
# Set SOLSTY_API_TOKEN in your private environment first.
$apiBase = 'https://api.solsty.net/v1/api'
$apiToken = $env:SOLSTY_API_TOKEN
if (-not $apiToken) { throw 'Set SOLSTY_API_TOKEN first.' }
$headers = @{ Authorization = "Bearer $apiToken" }

# Discover the available resources and writable columns.
Invoke-RestMethod "$apiBase/resources" -Headers $headers

# Read a page of your synced tasks.
$page = Invoke-RestMethod "$apiBase/records/todos?limit=100" -Headers $headers
$page.rows

# If has_more is true, continue with next_cursor.
# Download your synced account data as JSON.
Invoke-RestMethod "$apiBase/export" -Headers $headers

// Run server-side. Keep your personal token private.
const apiBase = 'https://api.solsty.net/v1/api';
const token = process.env.SOLSTY_API_TOKEN;
if (!token) throw new Error('Set SOLSTY_API_TOKEN first.');

const response = await fetch(apiBase + '/records/todos?limit=100', {
  headers: { Authorization: 'Bearer ' + token },
});
if (!response.ok) {
  throw new Error('Request failed: ' + response.status);
}

const { rows, has_more, next_cursor } = await response.json();
// Use rows in your workflow. If has_more is true, pass next_cursor
// as the cursor query parameter to retrieve the next page.

03 / TEMEL BİLGİLER

Nerede ne var?

Aşağıdaki yolların temel adresi: https://api.solsty.net/v1/api . Her istek kişisel API token’ı gerektirir.

Bir sayfa, sonra bir sonraki.

Kayıt listeleri ve eşitleme sorgularında sayfa boyutu: limit 1–500 arasında olabilir (varsayılan 100). Devam koşulu: has_more true olduğunda sonraki imleç: next_cursor. Her imleci yalnızca alındığı uç noktada kullan. İlk eşitleme sorgusu için başlangıç: since=1970-01-01T00:00:00Z.

Eşitleme sözleşmesine göre yaz.

Push işlemi en fazla 500 öğe kabul eder. Dizi adı: operations . Her öğede şu alanlar bulunur: id, table, rowId, op ve queuedAt, ayrıca payload alanı upsert için gereklidir. Kimlikler UUID, zaman damgası RFC3339 biçimindedir. İşlem türü: upsert veya delete.

Önce yazılabilir kolonları keşfet. Uç nokta: /resources . Upsert, kısmi PATCH yerine tam satır gerektirir; güncellerken kayıt kimliğini ve doğal anahtarı koru. Her işlem grubu bütünüyle uygulanır veya geri alınır. Silinen kayıtlarda silme işareti kalır; upsert ile geri getirilemezler.

04 / ASİSTANIN GÜNÜNÜ TANISIN

Uyumlu MCP istemcini Solsty’ye bağla. Taşıma türü: Streamable HTTP ; kimlik doğrulama kişisel token ile yapılır. Ajandanı incelemek için salt okuma, değişiklik yapabilmek için okuma-yazma yetkisi seç.

✳Asistanın

↔

⌘MCP

↔

Solsty

1. Solsty’de token oluştur.

   Yukarıdaki token adımlarını izle. Her bağlantıya ayrı isimli bir token ver; böylece erişimleri tek tek iptal edebilirsin.

2. Uzak MCP sunucusu ekle.

   Streamable HTTP’yi seç. Sunucu adresi: https://api.solsty.net/mcp . Eklenecek başlık: Authorization ; başlığın değeri: Bearer YOUR_TOKEN. İstemcin özel HTTP başlıklarını desteklemeli; yalnız OAuth ile bağlanan istemciler desteklenmez.

3. Bağlan ve araçları keşfet.

   İstemcinin bağlantı kontrolünü çalıştır. Ardından şu araçları dene: list_resources veya list_records ; kullanılacak parametre: table: "todos". Salt okuma token’ları dört araç sunar; yazma token’larında ayrıca şu araç bulunur: push_changes.

{
  "url": "https://api.solsty.net/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_SOLSTY_API_TOKEN"
  }
}

Bunlar bağlantı alanlarıdır; her istemcide kullanılabilen tam bir yapılandırma dosyası değildir. İstemcinin beklediği uzak sunucu bölümüne ekle. Yerel Solsty paketi veya eski /sse bağlantısı gerekmez.

05 / BİRKAÇ YARARLI AYRINTI

Anahtarlar sende.