Bağlamak bir komut sürer
MCP destekleyen istemciye adresi ekle ya da REST’ten çağır. İkisi de aynı anahtarla çalışır ve aynı krediden düşer. Kurman gereken paket yok.
- Kayıt ol. Ücretsiz kayıt ol, ayda 1.000 kredi. Anahtarı panelde üretirsin;
ak_live_ile başlar ve bir kez gösterilir. - İstemcine ekle. MCP adresi
https://api.kilavuzapi.com/mcp, anahtarAuthorization: Bearerbaşlığında. - Sor. Ajan doğru aracı kendisi seçer; veri döndüren her yanıt
kaynakveguncellemealanını yazar.
MCP
AçıkStreamable HTTP; yanıt düz JSON, SSE akışı yok. 129 araç, REST’le aynı kredi. Araç listesi ücretsiz; kredi yalnız araç çağrısında düşer.
Terminalde bir kez çalıştır:
claude mcp add --transport http kilavuz https://api.kilavuzapi.com/mcp \
--header "Authorization: Bearer $KILAVUZ_ANAHTAR"Önce export KILAVUZ_ANAHTAR="ak_live_…"; kabuk anahtarı komuta yerleştirir. Tüm projelerde kullanmak için --scope user ekle.
~/.cursor/mcp.json ya da projede .cursor/mcp.json içine:
{
"mcpServers": {
"kilavuz": {
"url": "https://api.kilavuzapi.com/mcp",
"headers": {
"Authorization": "Bearer ${env:KILAVUZ_ANAHTAR}"
}
}
}
}Anahtarı KILAVUZ_ANAHTAR ortam değişkeninden okur; dosyaya yazmak zorunda kalmazsın.
Projede .vscode/mcp.json içine (GitHub Copilot ajan modu):
{
"inputs": [
{
"type": "promptString",
"id": "kilavuz-anahtar",
"description": "Kılavuz API anahtarı",
"password": true
}
],
"servers": {
"kilavuz": {
"type": "http",
"url": "https://api.kilavuzapi.com/mcp",
"headers": {
"Authorization": "Bearer ${input:kilavuz-anahtar}"
}
}
}
}Anahtarı ilk bağlantıda sorar ve gizli saklar; dosyaya yazılmaz.
Ayarlar → Connectors → Add custom connector. Bu adresi yapıştır, açılan sayfada Google ile giriş yap ve izin ver:
https://api.kilavuzapi.com/mcpAnahtar gerekmez; hesabın yoksa girişte açılır. Masaüstü uygulaması aynı bağlayıcıyı kullanır. Bağlantıyı panelde Bağlantılar bölümünden kesersin.
REST
AçıkVeri döndüren her yanıtta kaynak ve guncelleme alanı; kredi düşen istekte kalan kredi X-Kalan-Kredi başlığında. Hata her uçta aynı biçimde: {"hata": "…"} ve anlamlı bir HTTP durum kodu. Bütün uçlar dokümanda.
Anahtarsız deneme ucu, sonra anahtarla gerçek uç:
# anahtarsız deneme
curl "https://api.kilavuzapi.com/v1/demo/deprem"
# anahtarla
curl -G "https://api.kilavuzapi.com/v1/akaryakit/fiyat" \
--data-urlencode "il=Ankara" --data-urlencode "urun=motorin" \
-H "Authorization: Bearer $KILAVUZ_ANAHTAR"Node 18+, Deno, Bun ya da tarayıcı; paket gerekmez:
const url = new URL('https://api.kilavuzapi.com/v1/akaryakit/fiyat');
url.search = new URLSearchParams({ il: 'Ankara', urun: 'motorin' }).toString();
const yanit = await fetch(url, {
headers: { Authorization: `Bearer ${process.env.KILAVUZ_ANAHTAR}` },
});
const veri = await yanit.json();
console.log(veri.kaynak, veri.guncelleme, yanit.headers.get('x-kalan-kredi'));Yalnız standart kütüphane:
import json, os, urllib.parse, urllib.request
q = urllib.parse.urlencode({"il": "Ankara", "urun": "motorin"})
istek = urllib.request.Request(
f"https://api.kilavuzapi.com/v1/akaryakit/fiyat?{q}",
headers={"Authorization": f"Bearer {os.environ['KILAVUZ_ANAHTAR']}"},
)
with urllib.request.urlopen(istek) as y:
veri = json.load(y)
print(veri["kaynak"], veri["guncelleme"], y.headers["X-Kalan-Kredi"])Örnek kodlar → Adres formu, şehir kartı, hastane bulucu, kargo kartı ve deprem botu; her biri tek dosya, paketsiz.
129 araç
Adlar canlı tools/list yanıtıyla aynı sırada.
adres_cozadres_toplu_cozadres_ayristirposta_kodu_ilceplaka_ilbarkod_kontroladres_listesiters_geokodmesafesokak_tamamlaiban_dogrulaiban_toplu_dogrulaiban_bankalarkur_listesikur_cevirkur_ecbakaryakit_fiyatson_depremleribb_trafikibb_otoparkibb_hava_kalitesiibb_metro_durumibb_nokta_araaltin_fiyatibaraj_dolulukhava_durumuhava_kalitesivergi_dairesi_bultufekira_artis_oranipolitika_faizippk_kararlarituik_gostergelertuik_bultenlertuik_serienerji_tarifesiuniversite_listesiprogram_arasinav_takvimiyks_puanilgs_puaniyasal_faizavukatlik_ucretinoter_ucretiilac_aragtip_aragtip_kodnace_aranace_kodisg_tehlike_sinifigecis_ucretiyol_maliyetikasko_degeritrafik_azami_primarac_otv_hesapladask_primiokul_arahastane_aravergi_parametrelerigelir_vergisi_hesaplakdv_hesaplamtv_hesaplavergi_takvimivergi_oranlarigecikme_zammi_hesaplatecil_faizi_hesaplayeniden_degerlemefatura_dogrulaozelge_araozelge_okubordro_hesaplatazminat_hesaplaasgari_ucrettrafik_cezasitrafik_cezasi_indirimharctapu_harciemlak_vergisidamga_vergisiveraset_vergisihal_fiyatborsa_fiyattmo_piyasa_fiyatguvensiz_urunresmi_gazetetckn_dogrulavkn_dogrulatelefon_dogrulakart_dogrulakargo_takiptakip_no_tanikargo_etiketiteslim_tahminiis_gunu_eklenamaz_vakitlerihicri_tarihkvkk_maskelecayma_hakkifatura_suresiil_bilginufusil_ilceleralan_kodubolge_listesiyaziylaslugadres_ayni_miadres_kisaltmaturkce_siralaad_normalizeturkce_ektarih_ayristirturkcelestirmetin_ayikladesitest_verisi_uretresmi_tatillergun_bilgisiis_gunu_sayfutbol_liglerfutbol_takimlarfutbol_puan_durumufutbol_fiksturfutbol_sonuclarfutbol_gol_kralligifutbol_macfutbol_formfutbol_h2hkesinti_sorgula