AI agent'larının bir terminal ile eşleştirilmiş cihazlar arasında uçtan uca şifreleme kullanarak güvenli bir şekilde dosya, metin ve medya göndermesini ve almasını sağlar.
Ayrıca bilinen adı paironce/cli, cli
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.11.4
- Son commit
- 7 Kas 2026
- Lisans
- Apache-2.0
PairOnce MCP nedir?
PairOnce bir MCP sunucusudur. AI agent'larının bir terminal ile eşleştirilmiş cihazlar arasında uçtan uca şifreleme kullanarak güvenli bir şekilde dosya, metin ve medya göndermesini ve almasını sağlar.
Özet, projenin README dosyasından oluşturuldu
PairOnce MCP sunucusu hakkında
PairOnce, AI agent'larının kişisel cihazlarınızla dosya, metin ve medya alışverişi yapması için güvenli bir yol sunar. Sunucuyu npx paironce mcp komutuyla çalıştırarak, bir agent; iPhone, Android veya masaüstü bilgisayar gibi web tarayıcısı çalıştıran herhangi bir cihazla etkileşime girebilir. Bu kurulum herhangi bir hesap gerektirmez ve verilerinizi korumak için uçtan uca şifreleme kullanır. Bağlantı, mobil veya masaüstü cihazınızda onayladığınız altı haneli bir eşleştirme kodu aracılığıyla kurulur.
Geliştiriciler, terminal ortamı ile fiziksel dünya arasındaki boşluğu doldurmak için bu sunucuyu kullanabilirler. Agent, derleme günlüklerini (build logs) telefonunuza gönderebilir veya bir donanım etiketinin fotoğrafı ya da bir belge taraması gibi belirli öğeleri talep edebilir. Görsel asistanlık için özelleşmiş araçlar içerir; bu sayede agent, manuel görevlerde size rehberlik etmek için kamera veya ekran karelerini talep edebilir. Sunucu, sürekli manuel onay gerektirmeden akıcı iş akışları sağlamak için son tool call işleminden sonra 30 dakika boyunca bağlantıyı korur.
Neler yapabilirsiniz
- 1Terminal verilerini mobile aktarmaBir AI agent'ına belirli bir derleme günlüğünü veya dosyayı doğrudan akıllı telefonunuza göndermesini söyleyebilirsiniz.
- 2Fiziksel dünya bilgilerini yakalamaBir agent, bir görevi tamamlamanıza yardımcı olmak için sizden belirli bir nesnenin fotoğrafını çekmenizi isteyebilir.
- 3Taranmış belgeleri çalışma alanına almaBir agent'ın, telefonunuzdan yerel bir klasöre tarama veya fotoğraf yüklemenizi beklemesini sağlayabilirsiniz.
- 4Görsel adım adım kılavuzlukAgent, karmaşık prosedürlere yardımcı olmak için kameranızdan veya ekranınızdan periyodik olarak hareketsiz görüntüler talep edebilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
PairOnce MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıPairOnce MCP'yi Claude Code içine yükleyin
$ claude mcp add cli -- npx -y paironcePairOnce MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"paironce"
]
}
}
}PairOnce MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"paironce"
]
}
}
}PairOnce MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"paironce"
]
}
}
}PairOnce MCP'yi Codex içine yükleyin
~/.codex/config.toml
[mcp_servers.cli] command = "npx" args = ["-y", "paironce"]
PairOnce MCP'yi Gemini CLI içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"paironce"
]
}
}
}Yapılandırma
PAIRONCE_NAME
| Ad | Açıklama | Sunucu |
|---|---|---|
| PAIRONCE_NAME | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirpaironce/cli is public and reachablegithub.com/paironce/cli ↗Geçti
- Paket bu depoyu kaynak olarak gösteriyorpaironce names paironce/cli as sourcenpmjs.com/package/paironce ↗Geçti
- Derleme kaynağı (Sigstore onayı)Sigstore attestation for paironcenpmjs.com/package/paironce/v/0.11.4#provenance ↗Geçti
- Açık kaynak lisansı (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-07github.com/paironce/cli ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from paironceGeçti
- Pakette ve bağımlılıklarında kritik uyarı yok21 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak endpoint MCP el sıkışmasına yanıt veriyorKontrol edilmedi
paironce
Send files and text from a terminal to your own phone or computer with PairOnce. Pair once with
a six-digit code; after that, npx paironce send report.pdf puts the file on your phone. End-to-end encrypted, direct
between the devices whenever the network allows, and through an encrypted relay when it does not. No account.
npx paironce pair # shows a code: type it at paironce.com on your phone
npx paironce send build.zip # sends to the paired device
npx paironce text "https://example.com/some/long/link"
npx paironce receive --to ./inbox # receives files sent from the phone
The other device is any browser with https://paironce.com open: iPhone, Android, Windows, Mac or Linux. Nothing to install there.
Commands
| Command | What it does |
|---|---|
paironce pair |
Shows a six-digit code. On the other device, open paironce.com, choose Enter a code and type it. Both screens show the same safety code; approve the device in the terminal. |
paironce pair 123456 |
Joins with the code the other device shows, for a person at this terminal. |
paironce send <file>... |
Sends files to the paired device. With several paired devices, add --to "<name>". The other device accepts each file before it arrives. |
paironce text "<message>" |
Sends a message or a link. |
paironce receive |
Receives files into the current folder (--to <folder>). Asks before each file; --yes accepts every file during this run. Large files are written straight to disk, so they can be as large as the sender may send, and one cut off continues when it is sent again. |
paironce devices |
Lists paired devices. |
paironce forget <name> |
Forgets a paired device. |
paironce mcp |
Runs as an MCP server for AI agents. |
--name "<name>" (or the PAIRONCE_NAME variable) sets what the other device shows for this one, for example
--name "Build server". The key stays the same, so paired devices still know it. --agent marks this device as an AI
agent on the other device (the MCP server always does). The MCP server stays connected for 30 minutes after its last tool call, so the next task needs no tap on your device; you see it as connected and can end it there. The MCP tools save inside the folder the server runs in (inbox by default). --ephemeral uses a throwaway identity in a temporary folder,
which the other device forgets after a day without a connection: right for a sandbox that is thrown away.
When a paired device is not connected, the command asks it to connect: PairOnce on that device shows "Windows · Terminal wants to reconnect" with a Connect button.
Use it from an AI agent (MCP)
paironce mcp gives an agent ten tools:
| Tool | What it does |
|---|---|
pair_device |
Pairs one of your devices. The agent gives you a six-digit code; you open paironce.com on that device, choose Enter a code and type it. The agent then tells you a safety code, and goes on only after you say your device shows the same. Once per device. |
send_file, send_text |
Sends to a paired device; you accept every file there. |
receive_files |
Waits while you send files from your device (a photo of a whiteboard, a scan, a document) and saves them into ./inbox. |
request_photo, request_scan, request_file |
Asks for something specific, with the reason. Your device shows the request; you take the photo, scan the pages or choose the file there, or decline. Saved into ./inbox. |
watch_frames, watch_stop |
Asks to see your camera or screen, with the reason. You share it on your device, or decline; the agent then gets a still picture each time it asks (at most two a second) and can guide you step by step. Your device shows the share and a stop button; it ends when either side stops it. |
list_devices |
Lists the paired devices. |
The agent reaches only devices you paired and approved, and nothing arrives anywhere unasked. Your device marks it Agent when it asks to be approved and in your saved devices. Design and plans: Agent as a Device.
send_file does not send hidden files and folders (such as .env or .ssh), Windows's AppData, a Mac's Library or this
device's own PairOnce files; you can still send those yourself with paironce send. A file that arrives after receive_files
or a request stopped waiting is saved in the folder it was accepted for, and the next receive_files reports it. Changes in
each version are in the releases.
Claude Code:
claude mcp add paironce -e PAIRONCE_NAME="Claude Code · Agent" -- npx -y paironce mcp
# in a throwaway sandbox: ... -- npx -y paironce mcp --ephemeral
# on Windows, through cmd: claude mcp add paironce -- cmd /c npx -y paironce mcp
Other clients (Cursor, Claude Desktop and others), in their MCP configuration:
{ "mcpServers": { "paironce": { "command": "npx", "args": ["-y", "paironce", "mcp"], "env": { "PAIRONCE_NAME": "Cursor · Agent" } } } }
Then ask: "pair with my phone", "send the build log to my phone", or let the agent ask you: "I need a photo of the label on the back of the router".
How it works
The CLI runs the same connection code as paironce.com: the PairOnce protocol and @paironce/core for pairing and encryption, with WebRTC from node-datachannel for direct connections and @roamhq/wrtc (libwebrtc) for the relay. Files and messages are encrypted on this computer and decrypted on the other device; the PairOnce service only introduces the two devices and, when needed, relays encrypted bytes it cannot read.
This computer's device key and the list of paired devices are kept in ~/.paironce (or $PAIRONCE_HOME), readable only
by you. The private key never leaves this computer.
It connects directly whenever the networks allow it, otherwise through the encrypted relay over UDP, TCP or TLS on port
443, and where even that is blocked, through the PairOnce tunnel: the same encrypted data over a secure WebSocket to
paironce.com. So it works on servers, in containers that block UDP, and behind a web proxy (HTTPS_PROXY is used
automatically). In a cloud sandbox with an allow-list, such as Claude Code on the web, add paironce.com to the allowed
domains. PAIRONCE_DEBUG=1 shows each step of connecting.
Requires Node.js 22 or later on Windows, macOS (x64 and arm64) or Linux (x64 and arm64).
License
Apache-2.0. PairOnce is a trademark of its owner; see https://paironce.com.
PairOnce MCP soruları
PairOnce MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add cli -- npx -y paironce komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
PairOnce MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Cihazımı bir AI agent ile nasıl eşleştiririm?
Agent size altı haneli bir kod sağlar; bu kodu cihazınızdaki paironce.com adresine girersiniz, ardından her iki ekranda görünen güvenlik kodunu onaylarsınız.
Aktarım sırasında verilerim gizli kalıyor mu?
Evet, tüm dosyalar ve mesajlar uçtan uca şifrelenir ve özel anahtarınız bilgisayarınızdan asla ayrılmaz.
Agent'ın sürekli bağlı kalması gerekiyor mu?
MCP server, son tool call işleminden sonra 30 dakika boyunca bağlı kalır; böylece tekrar eşleştirme yapmadan sonraki görevlere devam edebilirsiniz.