Remote MCP

Yerel editör araçları MCP sunucusunu senin makinende başlatır. Barındırılan ajanlar bunu yapamaz, bu yüzden SecondOS ayrıca proje-kapsamlı bir token ile bağlandığın uzak bir endpoint de sunar. Aynı harita ve hafıza, HTTP üzerinden.

Yerel vs uzak

Ajanın nerede çalıştığına bağlı olarak aynı twenty-two araca ulaşmanın iki yolu:

• Yerel (stdio) — makinende çalışan ve bir süreç başlatabilen araçlar için: Cursor, Claude Code, Claude Desktop, Windsurf, VS Code. bunx @secondos/cli mcp-config komutunu çalıştır ve yazdırılan config'i yapıştır. Token yok, yerel ve senkronlanmış projeni okur.
• Uzak (barındırılan) — bulutta çalışan ve süreç başlatamayan ajanlar için: bir claude.ai özel connector'ı, ChatGPT veya herhangi bir MCP-over-HTTP istemcisi. Barındırılan /mcp endpoint'ine bir Bearer token ile bağlanırlar.

Token oluştur

Uzak token'lar proje başınadır. Bir projeyi aç, Integrations bölümüne git ve Remote MCP — connect a hosted agent kısmını bul. Token'a bir etiket ver (örneğin hangi ajan için olduğunu), sonra Create token de.

Token bir kez gösterilir. Tam o anda kopyala, bir daha asla gösterilmez, tıpkı bir CLI token'ı veya bir webhook secret'ı gibi. Kaybedersen iptal et ve yenisini oluştur.

Özel connector olarak ekle

Integrations paneli endpoint URL'sini ve yapıştırmaya hazır bir connector config'i gösterir. Barındırılan ajanında Streamable HTTP tipinde özel bir MCP connector'ı ekle:

• URL — panelde gösterilen endpoint, ör. https://secondos.app/mcp.
• Authorization header — Authorization: Bearer <token>.

{
  "mcpServers": {
    "secondos": {
      "url": "https://secondos.app/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Bağlandıktan sonra ajan, aynı codebase, hafıza ve context araçlarını herhangi bir yerel araç gibi çağırabilir, token'ın ait olduğu tek projeye kapsamlanmış olarak.

Kapsam & en az yetki

Uzak bir token tek bir projeye bağlıdır ve yalnızca okuma ve hafıza araçlarını taşır: haritayı ara, etkiyi izle, remember ve recall. Hesabına, faturana, diğer projelerine veya kaynağına dokunamaz (kaynak zaten hiç yüklenmedi). Token'ı aynı panelden istediğin an iptal et; onu kullanan ajan erişimini anında kaybeder.

Sonraki

Tam araç yüzeyi için MCP sunucusu'na, yerel kurulum için CLI referansı'na veya güven sınırı için güvenlik'e bak.