Uzak MCP adresi ve tarayıcı yetkilendirmesiyle yapay zekâ asistanınızı OmniaKey'e bağlayın.
01
Limitli bir API anahtarı hazırlayın
Panelde MCP için ayrı bir anahtar oluşturun. Sınırsız kotayı kapatın, düşük bir harcama limiti ve son kullanma tarihi belirleyin, gerekli modelleri seçin.
API anahtarı alınhttps://api.omniakey.com/mcpBu adresi aynen MCP istemcisine girin ve HTTP ile OAuth kullanın. Sonu /mcp/ olan adres yardım sayfasıdır; protokol uç noktası değildir.
02
OmniaKey'i istemciye ekleyin
İstemcinizi seçip ayarları kopyalayın. omniakey kaydı zaten varsa önce eski kaydı değiştirin. Komutlara veya ayar dosyalarına anahtar eklemeyin.
codex mcp add omniakey --url https://api.omniakey.com/mcp
codex mcp login omniakeyKomutları Codex CLI kurulu terminalde çalıştırın. login tarayıcı yetkilendirmesini açar. Ardından Codex'e dönüp bağlantıyı yenileyin veya yeni oturum başlatın.
claude mcp add --transport http omniakey https://api.omniakey.com/mcpKomutu çalıştırıp Claude Code'da /mcp yazın. omniakey'i seçerek tarayıcıda yetkilendirmeyi tamamlayın.
{
"mcpServers": {
"omniakey": {
"url": "https://api.omniakey.com/mcp"
}
}
}Kaydı projenizin .cursor/mcp.json dosyasına ekleyin. MCP ayarlarında omniakey'i etkinleştirip giriş adımlarını izleyin. Authorization başlığı eklemeyin.
{
"servers": {
"omniakey": {
"type": "http",
"url": "https://api.omniakey.com/mcp"
}
}
}Kaydı .vscode/mcp.json içine ekleyin. MCP: List Servers üzerinden omniakey'i başlatın, güven istemini inceleyin ve tarayıcıda yetkilendirin.
İstemcilerin resmî kılavuzları
03
Tarayıcıda yetki verin
İstemci api.omniakey.com/mcp/oauth/authorize adresini açar. Özel anahtarı girmeden önce adresi ve dönüş hedefini kontrol edin.
- Anahtarı yalnızca yetkilendirme sayfasının parola alanına yapıştırın. Hizmet anahtarı şifreler; asistana ayrı bir OAuth belirteci verir.
- İlk bağlantıyı salt okunur bırakın. Ücretli üretimi ve iptali işaretlemeyin.
- İlk kontrol için bir saat seçip Connect'e tıklayın. Daha sonra üretimi açarken günlük istek sınırı da belirleyin; bu sınır anahtarın harcama bütçesinden ayrıdır.
04
Üretim yapmadan doğrulayın
İstemciye dönüp bu isteği gönderin. Model ve şema sorguları üretim görevi başlatmaz.
OmniaKey MCP veya CLI bağlantısının hazır olduğunu doğrula. Erişilebilir modelleri listele ve ortak medya isteği şemasını oku. Üretim görevi gönderme.Salt okunur bağlantı omniakey_models, omniakey_schema, omniakey_get_task ve omniakey_wait_task araçlarını gösterir. Model listesinin gerçekten döndüğünü doğrulayın; bağlı göstergesi tek başına yeterli değildir.
Üretimi açın veya erişimi kaldırın
Üretim izniyle yeniden bağlanıp önce fiyatı kontrol edin. Metin için 1–4096 arası max_tokens veya max_completion_tokens gerekir. Aynı anahtarla bağlantıları yönetin. Erişimi kaldırmak yeni çağrıları durdurur; gönderilmiş görevler tamamlanabilir.
Bağlantıları yönetin veya kaldırınModelinizi bulun
API anahtarınızın erişebildiği modelleri sorgulayın, ardından belgelenen özelliklerini ve güncel fiyatlarını kontrol edin.
Bir istek gönderin
Metin ve asenkron görsel, video veya ses görevleri için aynı OmniaKey API'sini kullanın.
Kaldığınız yerden sürdürün
Görev id değerini saklayın ve sorgulamaya devam edin. Yerel zaman aşımı ikinci bir üretim başlatmaz.
Girdiden sonuca bir görev
Üretimi açtıktan sonra model ve girdileri kontrol edip tek bir ücretli görev gönderin. Sonucu almak için dönen ID'yi saklayın.
Anahtarımla kullanılabilen bir görsel modeli bul, zorunlu girdileri ve güncel fiyatı göster. Bir görsel üretmeden önce onayımı bekle. Sabit idempotency anahtarıyla bir kez gönder, görev ID'sini sakla ve ilerlemeyi bu ID ile sorgula. Bekleme süresi dolarsa yeniden gönderme.05
Sunucunun sunduğu araçlar
Uzak bağlantı yalnızca izin verdiğiniz araçları gösterir. Model, şema ve görev sorguları okuma; üretim ve iptal ise ayrı izinler gerektirir.
| Araç | Ne yapar | Gerekli izin |
|---|---|---|
omniakey_models | API anahtarınız için kullanılabilir modelleri isteğe bağlı arama ve sonuç sınırıyla listeler. | Salt okunur |
omniakey_schema | Ağ isteği yapmadan ortak sohbet veya medya istek zarfını döndürür. | Salt okunur |
omniakey_chat | Akışsız bir sohbet tamamlama çalıştırır. Yalnızca kullanıcı üretim istediyse kullanın. | Ücretli üretim |
omniakey_submit_task | Kararlı bir idempotency anahtarıyla ücretli görsel, video veya ses görevi gönderir. | Ücretli üretim |
omniakey_get_task | Bir görevi id ile okur ve başarılıysa taze imzalı varlık URL'leri ekler. | Salt okunur |
omniakey_wait_task | Bir görevi en fazla 45 saniye bekler; yerel zaman aşımı görevi iptal etmez veya yeniden göndermez. | Salt okunur |
omniakey_cancel_task | Var olan bir görevin iptalini ister. İptal süreçte kalabilir, doğrulamak için durumu sorgulayın. | İptal isteği |
06
stdio ile yerel çalıştırma
Yerel bağlantı için Node.js 22+, npm ve Git gerekir. İstemci sunucuyu başlatır ve anahtarı ortamından okur.
Yerel ayarları ve ortam değişkenlerini göster
Aşağıdan istemcinizin yapılandırmasını seçin. Sunucu yerel stdio kullanır; ortamı yapılandırdıktan sonra istemciyi yeniden başlatın.
[mcp_servers.omniakey]
command = "npx"
args = ["--yes", "github:omniakey-com/omniakey-devtools#v0.1.0", "mcp"]
env_vars = ["OMNIAKEY_API_KEY"]claude mcp add --transport stdio omniakey -- npx --yes github:omniakey-com/omniakey-devtools#v0.1.0 mcp{
"mcpServers": {
"omniakey": {
"command": "npx",
"args": [
"--yes",
"github:omniakey-com/omniakey-devtools#v0.1.0",
"mcp"
]
}
}
}{
"inputs": [
{
"type": "promptString",
"id": "omniakey-api-key",
"description": "OmniaKey API key",
"password": true
}
],
"servers": {
"omniakey": {
"type": "stdio",
"command": "npx",
"args": [
"--yes",
"github:omniakey-com/omniakey-devtools#v0.1.0",
"mcp"
],
"env": {
"OMNIAKEY_API_KEY": "${input:omniakey-api-key}"
}
}
}
}{
"mcpServers": {
"omniakey": {
"command": "cmd",
"args": [
"/c",
"npx",
"--yes",
"github:omniakey-com/omniakey-devtools#v0.1.0",
"mcp"
]
}
}
}Anahtarı terminaldeki gizli girişe yapıştırıp Enter tuşuna basın. Ajanı bu ortamdan başlatın; anahtarı isteme veya depoya yazmayın.
read -s OMNIAKEY_API_KEY
export OMNIAKEY_API_KEY$env:OMNIAKEY_API_KEY = [System.Net.NetworkCredential]::new('', (Read-Host 'OmniaKey API key' -AsSecureString)).PasswordMCP bağlantısını yenileyip ajandan salt okunur kontrol isteyin. Anahtar eksikse istemci ortam değişkenini almamıştır.
07
Sorun giderme
Tekrar denemeden önce bağlantı türünü, yetkiyi ve anahtar sınırlarını kontrol edin.
Anahtarım reddediliyor
Sınırsız kotayı kapatıp son kullanma tarihi belirleyin ve anahtarın etkinliğini kontrol edin. Model ve IP kısıtlamaları uzak Worker isteklerine izin vermelidir.
401 görüyorum veya bağlanamıyorum
/mcp adresini OAuth olmadan açmak normalde 401 döndürür. İstemciden bağlanıp yetkilendirin. 403 veya HTML gelirse adresi ve olası kenar ağı engellerini kontrol edin.
Üretim araçları görünmüyor
Salt okunur bağlantıda dört araç vardır. Yeniden bağlanıp ücretli üretimi açarak metin ve medya araçlarını ekleyin. İptal için ayrı izin gerekir.
İstek veya bağlantı süresi doldu
Görev ID'sini saklayıp yeni görev oluşturmadan sorgulamaya devam edin. Süresi dolan bağlantıyı yeniden yetkilendirin. Sızan anahtarı panelden devre dışı bırakın.
08
Bu araç hakkında
Streamable HTTP · OAuth
Uzak MCP'yi OmniaKey barındırır. Yerel CLI/stdio örnekleri v0.1.0 sürümünü kullanır. İki yöntem de aynı genel model ve görev API'lerini çağırır.
- Lisans
- MIT
- Mimari
- MCP → OAuth → api.omniakey.com/v1
- Testler
- Protokol ve güvenlik testleri örnek yanıtlar kullanır; gerçek ücretli üretim yapmaz.
- Anahtar işleme
- Bu kılavuz anahtar toplamaz. Yalnızca API sunucusundaki yetkilendirme formu özel anahtarı alıp şifreler. İstemci ayrı ve iptal edilebilir bir belirteç alır.
Sık sorulan sorular
Model fiyatları değişir mi?
Hayır. Araçlar mevcut API anahtarınızı ve API'nin faturalandırma kurallarını kullanır. Model listeleme ve yerel şema kontrolleri üretim başlatmaz; metin ve medya üretimi ücretli olabilir.
Bekleme süresi dolarsa ne olur?
Uzak görev iptal edilmez veya yeniden gönderilmez. id değerini saklayıp task get veya task wait ile devam edin. Dosya bağlantıları sona erdiğinde yeni bağlantı için aynı görevi sorgulayın.
Barındırılan bir MCP URL'si var mı?
Evet. https://api.omniakey.com/mcp adresini Streamable HTTP ve OAuth ile kullanın. Yerel stdio ayarları da aşağıdadır.
Ajan üretilen dosyaları indirebilir mi?
Hayır. Görev araçları meta veri ve imzalı varlık URL'leri döndürür. URL'ler geçerliyken dosyaları kendi araçlarınızla indirin.
MCP sunucusu bir modelin döndürdüğü araç çağrılarını çalıştırır mı?
Hayır. OmniaKey işlemlerini istemciye sunar; hangi çağrıların yapılacağına istemci ve kullanıcı karar verir. Üretim açık bir kullanıcı isteği gerektirir.