Hubungkan Intura MCP ke Hermes Agent: AI Visibility dan Website Audit Lewat Chat

Bagaimana cara menghubungkan Intura MCP ke Hermes Agent?

1. 1

   Salin API key dari dashboard

   Buka Integrations → MCP di dashboard Data AI Search lalu salin API key Anda. Halaman itu juga menampilkan URL server lengkap yang sudah berisi key, yang cocok untuk aplikasi Claude tapi bukan yang Anda butuhkan di sini: di Hermes, key dan URL disimpan terpisah. Perlakukan key ini seperti password. Siapa pun yang memegangnya bisa membaca workspace dan menjalankan audit yang memakai kreditnya.

2. 2

   Simpan key di ~/.hermes/.env

   Tambahkan key ke ~/.hermes/.env sebagai INTURA_API_KEY. Hermes mengisi placeholder ${VAR} di config.yaml dari environment dan file ini, jadi config bisa menyebut key tanpa memuatnya. Dengan begitu key tidak ikut terbawa saat file config ditempel ke chat, dibagikan ke rekan kerja, atau di-commit ke repo dotfiles. Kalau variabelnya tidak ada, Hermes membiarkan placeholder itu sebagai teks apa adanya dan server membalas dengan error autentikasi, jadi itu hal pertama yang perlu dicek kalau langkah 4 gagal.

   echo 'INTURA_API_KEY=paste_your_key_here' >> ~/.hermes/.env

3. 3

   Tambahkan server di bawah mcp_servers pada config.yaml

   Buka ~/.hermes/config.yaml lalu tambahkan entri intura yang hanya berisi url. Key dimasukkan ke URL sebagai ?api_key=, bukan ke header. Di langkah inilah orang sering salah: dokumentasi Hermes mencontohkan server remote yang login lewat headers: Authorization: Bearer, dan meniru pola itu akan gagal di sini, karena server Intura membaca header Bearer sebagai token login versi lama, bukan sebagai key workspace Anda. Server ini memakai Streamable HTTP, yang dipakai Hermes secara default untuk entri url, jadi baris transport tidak diperlukan.

   mcp_servers:
     intura:
       url: "https://api.dataaisearch.com/mcp?api_key=${INTURA_API_KEY}"

4. 4

   Reload dan tes koneksinya

   Ketik /reload-mcp di chat Hermes yang sedang berjalan, atau jalankan hermes mcp test intura dari terminal. Hermes memberi awalan nama server di setiap tool MCP, jadi tool Intura muncul sebagai mcp_intura_ diikuti nama tool-nya: mcp_intura_audit_list_website_audits, mcp_intura_category_get_questions, dan seterusnya. Kalau tes gagal dengan error autentikasi, berarti key tidak terbaca atau salah salin; kembali ke langkah 2. Kalau daftar tool muncul tapi panggilan tool membalas dengan pesan kredit, saldo workspace di bawah 1.

   hermes mcp test intura
   
   # or, inside a running chat
   /reload-mcp

5. 5

   Tentukan tool mana yang boleh dipanggil agent

   Gunakan daftar tools.exclude di entri server untuk menyembunyikan tool yang memakai kredit sungguhan sampai Anda percaya cara agent memakainya. Setiap panggilan tool Intura memakai 1 kredit, kecuali lima tool yang memotong biaya sama seperti aksi yang sama di dashboard: membuat proyek AI Visibility, menambahkan prompt ke proyek, menjalankan prompt, memulai Website Audit, dan menjalankan ulang audit dengan analisis AI. Agent yang diminta "cek visibility kita" bisa saja memutuskan bahwa run baru adalah cara terbaik untuk mengecek. Mengecualikan kelima tool itu membuat minggu pertama praktis read-only; hapus dari daftar saat Anda ingin agent memulai run untuk Anda.

6. 6

   Ajukan pertanyaan pertama dan cek tool mana yang dipanggil

   Mulai dengan pertanyaan yang hanya bisa dijawab dari workspace Anda, misalnya menampilkan daftar proyek AI Visibility, lalu perhatikan tool call di output Hermes. Kalau tidak ada panggilan mcp_intura_, berarti agent menjawab dari pengetahuannya sendiri dan angkanya karangan. Panduan ketiga di seri ini membahas kebiasaan ini lebih dalam; berlaku untuk semua MCP server, bukan hanya yang ini.

   List my AI Visibility projects with their latest mention rate. Use the Intura tools only, and tell me which tool you called.

Apa yang bisa dilakukan Hermes Agent dengan MCP server Intura?

Config dan prompt yang siap disalin

mcp_servers:
  intura:
    url: "https://api.dataaisearch.com/mcp?api_key=${INTURA_API_KEY}"
    tools:
      exclude:
        - audit_create_ai_visibility_project
        - audit_add_ai_visibility_prompts
        - audit_run_ai_visibility_prompts
        - audit_start_website_audit
        - audit_rerun_website_audit

Using the Intura tools, get the latest AI Visibility report for <project>. Give me the mention rate and citation rate per AI engine, the three buyer questions where we are not mentioned at all, and the top open next action. Quote the numbers exactly as the tool returned them.

In my latest Website Audit for <domain>, list the open problems on /pricing. I have fixed them. Re-check that page only, wait for the result, and tell me which problems are gone and which remain.

For the top 10 queries in Search Console for sc-domain:example.com over the last 28 days, check the Intura Category Overview for matching consumer questions. Which of those questions do AI engines answer without mentioning us?

Pertanyaan umum tentang Intura MCP dan Hermes Agent