Psephos Destek

sor, bildir, onayla.

Psephos, yapay zekâ ajanlarının riskli ya da geri alınamaz bir işlemden önce senden onay istemesini sağlar. İstek telefonuna Onayla/Reddet butonlu bir bildirim olarak düşer; tek dokunuşla cevaplarsın, cevabın ajana geri döner. Hesap açman gerekmez.

Kurulum

  1. Uygulamayı aç ve Devam'a dokun; bildirimlere izin ver.
  2. Test bildirimi gönder'e dokun. Bildirim gelince bildirime basılı tut: Onayla ve Reddet butonları açılır. Birine dokununca “Cevabın ulaştı ✓” bildirimi gelir.
  3. Uygulamadaki API anahtarını ajanına ver (aşağıda). Anahtar ve hazır komutlar her zaman Ayarlar'da.

Ajanını bağla

Claude Code

Terminalde bir kez çalıştır (ak_... yerine uygulamadaki anahtar; Ayarlar'daki Kopyala düğmesi komutu anahtarıyla birlikte kopyalar):

claude mcp add psephos -s user -e PSEPHOS_API_KEY=ak_... -- npx -y psephos-mcp

Windows'ta son kısım -- cmd /c npx -y psephos-mcp olur. Node.js 18 veya üstü gerekir. Sonra Claude Code'a örneğin “Psephos ile benden onay iste” diyebilirsin.

Diğer MCP istemcileri (Claude Desktop, Cursor…)

{
  "mcpServers": {
    "psephos": {
      "command": "npx",
      "args": ["-y", "psephos-mcp"],
      "env": { "PSEPHOS_API_KEY": "ak_..." }
    }
  }
}

Doğrudan HTTP

MCP kullanmayan ajanlar ve betikler için, Ayarlar'da sunucu adresiyle birlikte hazır bir curl örneği var: onay isteği POST /requests, cevabı okuma GET /requests/{id}, butonsuz bildirim POST /notify; hepsi x-api-key başlığıyla.

Sık sorulanlar

Bildirimde Onayla/Reddet butonlarını göremiyorum

Butonlar bildirime basılı tutunca açılır; dokunmak uygulamayı açar. Kilit ekranında da çalışır, telefonun kilidini açman gerekmez.

Bildirim gelmiyor

Ayarlar'da “Bildirim izni” Açık olmalı. Kapalıysa iOS Ayarlar → Psephos → Bildirimler'den aç. Odak (Rahatsız Etme) modları normal bildirimleri susturabilir; ajanın isteği kritik olarak gönderirse odak modunu deler. İnternet bağlantını da kontrol et.

“Cevap iletilemedi” dedi

Cevabın sunucuya ulaşamadı (çoğunlukla bağlantı). Uygulamayı açıp isteği projesinin içinden yeniden cevaplayabilirsin. Süresi dolmuş bir isteğe cevap kabul edilmez.

Bildirimi kaçırdım

Ekranın üstünden aşağı çekip Bildirim Merkezi'nden ya da uygulamadaki projenin içinden cevaplayabilirsin.

API anahtarım başkasının eline geçti

Şimdilik anahtarı yenilemenin yolu kimliği silip yeniden başlamak: Ayarlar → Kimliği sil, sonra Yeni kimlikle başla. Eski anahtar hemen geçersiz olur; ajanlarına yeni anahtarı ver.

Verilerimi nasıl silerim?

Ayarlar → Kimliği sil. Sunucuda sana ait hiçbir kayıt kalmaz. Uygulamayı telefondan silmek tek başına sunucudaki verini silmez. Ayrıntılar: Gizlilik Politikası.

Bir sınır var mı?

Bir anahtarla dakikada 30, günde 1000 bildirim ya da onay isteği; test butonuyla 10 dakikada 5 test.

İletişim

destek@psephos.dev — sorunu bildirirken Ayarlar'daki Kimlik no'yu ve uygulama sürümünü eklersen daha hızlı yardımcı olabiliriz.

Psephos Support

Psephos lets AI agents ask for your approval before a risky or irreversible action. The request arrives on your phone as a notification with Approve/Reject buttons (Onayla / Reddet); one tap answers, and the answer goes back to the agent. No account is needed. The app's interface is in Turkish.

Getting started

  1. Open the app, tap Devam (Continue) and allow notifications.
  2. Tap Test bildirimi gönder (Send test notification). When it arrives, press and hold the notification to reveal Onayla (Approve) and Reddet (Reject). Tapping one brings a “Cevabın ulaştı ✓” (Your answer arrived) confirmation.
  3. Give your agent the API key shown in the app (see below). The key and ready-made commands are always under Ayarlar (Settings, top left).

Connect your agent

Claude Code

claude mcp add psephos -s user -e PSEPHOS_API_KEY=ak_... -- npx -y psephos-mcp

On Windows end it with -- cmd /c npx -y psephos-mcp. Requires Node.js 18 or later. The copy button in Settings copies the command with your key filled in.

Other MCP clients (Claude Desktop, Cursor…)

{
  "mcpServers": {
    "psephos": {
      "command": "npx",
      "args": ["-y", "psephos-mcp"],
      "env": { "PSEPHOS_API_KEY": "ak_..." }
    }
  }
}

Plain HTTP

Settings has a ready curl example with the server address: create an approval request with POST /requests, read the answer with GET /requests/{id}, send a plain notification with POST /notify, all with an x-api-key header.

FAQ

I can't see the Approve/Reject buttons

Press and hold the notification; tapping it opens the app instead. It works on the lock screen too, without unlocking.

Notifications don't arrive

In Settings, “Bildirim izni” (notification permission) should read Açık (on). If not, enable it in iOS Settings → Psephos → Notifications. Focus modes can silence normal notifications; requests your agent marks as critical break through. Also check your connection.

It says “Cevap iletilemedi” (answer could not be delivered)

Your answer didn't reach the server, usually a connection problem. Open the app and answer the request again from its project. Expired requests no longer accept answers.

My API key leaked

For now, reset it by deleting the identity: Settings → Kimliği sil (Delete identity), then Yeni kimlikle başla (Start with a new identity). The old key stops working at once; give your agents the new one.

How do I delete my data?

Settings → Kimliği sil. Nothing belonging to you remains on the server. Deleting the app alone does not delete your data on the server. Details: Privacy Policy.

Are there limits?

Per key, 30 notifications or approval requests per minute and 1000 per day; the test button allows 5 tests per 10 minutes.

Contact

destek@psephos.dev — including the Kimlik no (identity number) from Settings and the app version helps us help you faster.