Panggilan tool MCP timeout? Periksa dulu sebelum coba lagi

Mengapa timeout tidak memberi tahu apakah perubahannya terjadi?

AI Anda meminta sebuah tool membuat perubahan, lalu menunggu. Tidak ada balasan, jadi aplikasi AI Anda berhenti menunggu dan melaporkan kegagalan. Label itu menggambarkan waktu tunggunya, bukan perubahannya. Jika Anda mencoba lagi perubahan yang sudah terjadi, Anda mendapat dua tiket, dua halaman, atau dua pesan.

Developer menyebut perubahan semacam itu operasi write. Ada tiga kemungkinan yang bisa terjadi.

Spesifikasi MCP memang mengantisipasi hal ini. Klien sebaiknya memasang timeout pada setiap permintaan dan, saat waktunya habis, membatalkan permintaan itu dan berhenti menunggu. Pembatalan bukan jaminan. Server bisa mengabaikannya saat pekerjaannya sudah selesai atau tidak bisa dihentikan. Pembatalan juga bisa sampai setelah balasan terkirim.

Panduan API Stripe mengatakan hal yang sama: setelah koneksi gagal, Anda mungkin tidak tahu apakah permintaannya dijalankan. Panduan itu juga meminta Anda memperlakukan kesalahan server sebagai hasil yang tidak diketahui.

Apa yang sebaiknya Anda lakukan setelah timeout, berurutan?

Kerjakan berurutan. Dua langkah pertama memakan waktu satu menit.

1. Hentikan coba lagiSekarang

   Beri tahu AI Anda untuk tidak mengulang panggilan: “Jangan coba lagi. Periksa dulu apakah sudah dibuat.” Coba lagi begitu saja adalah cara sebuah perubahan terbuat dua kali.

2. Periksa di tool-nya, bukan di chat1 menit

   Buka tool-nya langsung: halaman Notion, issue GitHub, folder itu. Cari judul atau ID yang Anda minta. Chat hanya tahu bahwa panggilannya gagal.

3. Baca apa yang Anda temukan2 menit

   Ditemukan dan lengkap: perubahannya sudah dibuat. Lanjutkan dan jangan mengulanginya.
   Ditemukan, setengah jadi: selesaikan bagian yang kurang dengan update, bukan create baru.
   Tidak ditemukan: permintaannya tidak pernah sampai, atau masih berjalan. Tunggu semenit dan periksa lagi.

4. Coba lagi sekali, dan hanya untuk panggilan yang amanKemudian

   Jika masih tidak ada, coba lagi sekali. Tabel di bawah menunjukkan panggilan mana yang aman diulang. Sebelum pengiriman, lihat ke mana ia sampai.

5. Jika terus timeout, perbaiki penyebabnyaSetelahnya

   Panggilan yang selalu timeout punya batas yang terlalu pendek atau pekerjaan yang terlalu besar. Naikkan batas untuk server itu, atau minta lebih sedikit per panggilan.

Panggilan mana yang aman dicoba lagi?

Sebuah panggilan aman dicoba lagi jika melakukannya dua kali menghasilkan hasil yang sama seperti sekali. Membaca termasuk. Banyak perubahan tidak. Standar HTTP menganggap PUT (mengatur sebuah nilai) dan DELETE aman diulang, dan baris-baris di bawah mengikutinya. Petunjuk idempotentHint atau deskripsi tool itu sendiri lebih utama daripada tabel ini.

Bisakah idempotency key mencegah duplikat?

Kadang bisa. Idempotency key adalah label unik yang dikirim bersama sebuah permintaan. Jika label yang sama datang dua kali, layanan itu mengerjakannya sekali dan mengulang jawaban pertamanya. Ia dibuat untuk permintaan yang tidak mendapat balasan.

• Cara kerja key di Stripe. API v1-nya menerima key pada permintaan POST. Ia menyimpan hasil pertama, bahkan jika itu error, dan mengembalikannya lagi untuk coba lagi dengan key yang sama. Key disimpan minimal 24 jam. Key yang sama dengan parameter lain ditolak.
• Apa yang harus dilakukan saat coba lagi. Kirim key yang sama dan parameter yang sama. Stripe menyarankan agar tidak mencoba lagi dengan key baru sebelum Anda tahu hasil yang pertama. Key baru di tiap usaha tidak memberi perlindungan.
• Yang diberikan MCP. Permintaan tools/call membawa nama tool dan argumennya. Skema spesifikasi tidak mendefinisikan idempotency key untuknya. Sebuah tool tetap bisa menerimanya sebagai argumen tersendiri, jadi baca argumennya.
• Apa yang boleh dinyatakan tool. idempotentHint menyatakan bahwa memanggil tool lagi dengan argumen yang sama tidak punya efek tambahan. Ia hanya petunjuk. Spesifikasi menyebut klien sebaiknya tidak pernah mendasarkan keputusan pada petunjuk dari server yang tidak mereka percaya.

Jadi key adalah bonus, bukan rencana. Jika tool tidak menawarkannya, pemeriksaan di atas yang melindungi Anda.

Bagaimana cara mengubah timeout MCP?

Batas yang terlalu pendek memotong pekerjaan yang jujur. Batas yang terlalu panjang membuat Anda menunggu. Di mana Anda mengaturnya bergantung pada aplikasi AI Anda. Berikut pengaturan Claude Code.

Bawaan 60 detik untuk server jarak jauh. Server yang dihubungi lewat HTTP, SSE, atau sebagai konektor claude.ai punya pengatur waktu kedua. Ia berjalan di setiap permintaan sampai byte respons pertama dari server. Ia berlangsung 60 detik, kecuali MCP_TOOL_TIMEOUT, timeout server, atau MCP_TIMEOUT diatur lebih tinggi. Server stdio lokal tidak punya pengatur waktu per permintaan.

Untuk mengaturnya untuk satu server, tambahkan "timeout": 600000 ke entrinya di .mcp.json. Itu sepuluh menit.

Panggilan yang lambat tidak selalu gagal. Mulai versi 2.1.212, Claude Code memindahkan panggilan MCP di percakapan utama Anda ke tugas latar belakang setelah dua menit. Hasilnya dikirim saat panggilan selesai.

Dokumentasi MCP Cursor tidak menjelaskan pengaturan timeout. Spesifikasi MCP tidak menyebut angka apa pun. Spesifikasi menyatakan SDK sebaiknya memungkinkan Anda mengatur timeout per permintaan, dan klien sebaiknya selalu menyimpan batas maksimum.

Untuk pekerjaan yang memakan menit, server bisa memakai MCP Tasks. Ia langsung mengembalikan handle, dan klien melakukan polling untuk hasilnya, bahkan setelah tersambung ulang. Kedua sisi harus mendukungnya, dan dukungan klien berbeda-beda.

Apa yang dilakukan Delta MCP saat balasan hilang?

Delta MCP adalah aplikasi gratis di komputer Anda, di antara AI Anda dan tool-nya. Saat sebuah perubahan tidak mendapat balasan, ia tidak menebak dan tidak sekadar mencoba lagi. Ia membaca tool-nya.

Sebelum perubahan keluar, Delta MCP memilih satu pembacaan yang bisa menunjukkan apakah perubahan itu terjadi. Pembacaan itu adalah membaca ulang objeknya, atau membaca ulang daftarnya. Jika tidak ada balasan, ia langsung menjalankan pembacaan itu. Apa yang ditampilkan pembacaan itu yang menentukan:

Panggilan tool yang dijalankan apa adanya tidak bisa diurungkan oleh Delta MCP. Jika panggilan sebelumnya berhasil, ia tetap terjadi, dan balasannya mencatatnya agar AI Anda tidak mengulanginya. Tiap tugas yang mengubah sesuatu disimpan di Activity, dengan setiap perubahan sebelum dan sesudahnya.

Cara sebuah tugas diperiksa dan diterapkan