Integrasi Model Context Protocol (MCP)

Titik akhir server MCP dengan akses yang sesuai.

Kredensi otentikasi untuk server MCP, jika diperlukan. Untuk informasi selengkapnya, lihat Siapkan penyiapan dan otentikasi server MCP.

Langganan Amazon Quick Enterprise.

Jika Anda terhubung ke server MCP pribadi, koneksi VPC Amazon Quick aktif yang memiliki akses jaringan ke server MCP. Untuk informasi selengkapnya, lihat Mengkonfigurasi koneksi VPC di Amazon Quick Sight.

Konektor melewati penemuan tetapi gagal dipublikasikan dengan Creation failed — Kesalahan ini biasanya berarti bahwa satu atau beberapa definisi alat dalam tools/list respons server MCP Anda mengandung yang tidak validinputSchema. Amazon Quick memvalidasi setiap alat inputSchema terhadap JSON Schema Draft 7 atau yang lebih baru selama fase publikasi.

Penyebab paling umum adalah sintaks Draft 3 yang tidak digunakan lagi, di mana required boolean di dalam definisi properti (misalnya,). "required": true Dalam JSON Schema Draft 7 dan yang lebih baru, required harus berupa array nama properti di root skema, sebagai saudara dari. properties

Perbarui definisi alat Anda untuk menggunakan format yang benar dan gunakan kembali server MCP Anda. Setelah Anda menerapkan ulang, hapus konektor yang gagal dan buat yang baru untuk memicu ulang penemuan dan publikasi.

Contoh berikut menunjukkan sintaks Draft 3 yang salah:

{
  "type": "object",
  "properties": {
    "logNumber": {
      "type": "string",
      "description": "The permit log number",
      "required": true
    }
  }
}

Contoh berikut menunjukkan sintaks Draft 7 yang benar:

{
  "type": "object",
  "properties": {
    "logNumber": {
      "type": "string",
      "description": "The permit log number"
    }
  },
  "required": ["logNumber"]
}

Beberapa pustaka kerangka kerja MCP dan generator kode memancarkan sintaks Draft 3 secara default. Periksa dokumentasi kerangka kerja Anda untuk opsi yang memilih versi keluaran Skema JSON. Anda juga dapat memvalidasi skema Anda dengan validator JSON Schema Draft 7 sebelum Anda menerapkan. Untuk informasi selengkapnya tentang inputSchema persyaratan, lihat Alat dalam spesifikasi Protokol Konteks Model.

Anda mungkin juga memperhatikan bahwa pembuatan konektor hang selama dua hingga lima menit sebelum gagal. Waktu yang berlalu mencerminkan percobaan ulang internal selama fase publikasi, bukan batas waktu jaringan. Perbaikannya sama: periksa inputSchema definisi alat Anda untuk kepatuhan JSON Schema Draft 7.

Koneksi VPC tidak tercantum dalam tarik-turun Jenis koneksi, atau pembuatan MCP gagal segera setelah Anda memilihnya — Koneksi VPC mungkin muncul di menu tarik-turun sebelum penyediaan selesai. Tunggu hingga koneksi VPC ditampilkan sebagai tersedia di halaman admin Amazon Quick sebelum Anda membuat integrasi MCP terhadapnya. Untuk informasi selengkapnya, lihat Mengkonfigurasi koneksi VPC di Amazon Quick Sight.

Pembuatan MCP gagal karena nama host server MCP tidak dapat diselesaikan - Amazon Quick tidak menggunakan resolver DNS VPC default untuk integrasi MCP. Anda harus mengisi bidang titik akhir DNS resolver pada koneksi VPC dengan alamat IP titik akhir masuk Route 53 Resolver yang dapat menyelesaikan nama host server MCP Anda. Persyaratan ini berlaku untuk nama host pribadi dan nama host publik yang ingin Anda selesaikan ke alamat pribadi dari dalam VPC, seperti titik akhir yang diawali oleh atau zona host pribadi AWS PrivateLink Route 53. Tanpa titik akhir resolver ini, nama host server MCP tidak dapat diselesaikan dan pembuatan integrasi gagal. Untuk informasi selengkapnya, lihat Mengkonfigurasi koneksi VPC di Amazon Quick Sight.

Server MCP tidak dapat dijangkau dari koneksi VPC - Lalu lintas dari Amazon Cepat ke server MCP Anda berasal dari subnet yang Anda pilih selama pengaturan koneksi VPC. Konfirmasikan bahwa tabel rute, ACL jaringan, dan grup keamanan memungkinkan lalu lintas antara subnet tersebut dan titik akhir server MCP. Untuk panduan jaringan VPC umum, lihat. Mengkonfigurasi koneksi VPC di Amazon Quick Sight

Otentikasi gagal saat Anda menggunakan server MCP pribadi — Saat Anda terhubung ke server MCP pribadi melalui koneksi VPC, titik akhir OAuth yang digunakan oleh server MCP masih harus dapat dijangkau melalui internet publik. Ini berlaku untuk otentikasi pengguna (otorisasi dan titik akhir token) dan otentikasi layanan (titik akhir token). Penyedia OAuth pribadi tidak didukung. Konfirmasikan bahwa URL OAuth yang dikembalikan oleh server MCP Anda dalam metadata sumber daya yang dilindungi diselesaikan melalui internet publik.

AADSTS9010010- titik akhir v2.0 menolak parameter sumber daya - Amazon Quick mengirimkan resource parameter pada permintaan OAuth seperti yang dipersyaratkan oleh spesifikasi MCP (RFC 8707). Entra ID v2.0 endpoint menolak permintaan yang menyertakan parameter dan nilai. resource scope Untuk mengatasi kesalahan ini, konfigurasikan pendaftaran aplikasi Anda untuk menggunakan endpoint Entra ID v1.0 OAuth dan atur accessTokenAcceptedVersion ke 2 dalam manifes aplikasi.

AADSTS90009— aplikasi meminta token untuk dirinya sendiri — Ketika Anda menggunakan otentikasi pengguna (aliran kode otorisasi) dan klien OAuth dan sumber daya MCP menyelesaikan ke aplikasi ID Entra yang sama, ID Entra memblokir permintaan. Buat dua pendaftaran aplikasi terpisah: satu aplikasi klien untuk Amazon Quick dan satu aplikasi sumber daya untuk server MCP. Masalah ini tidak memengaruhi autentikasi layanan (alur kredensi klien), tempat pendaftaran aplikasi tunggal berfungsi.

Operasi MCP memiliki batas waktu 60 detik yang tetap. Operasi yang melebihi batas ini secara otomatis gagal dengan kesalahan HTTP 424.

Untuk server MCP yang Anda jangkau melalui koneksi VPC, titik akhir OAuth yang digunakan oleh server MCP harus dapat dijangkau melalui internet publik. Ini berlaku untuk otentikasi pengguna dan otentikasi layanan. Penyedia OAuth pribadi tidak didukung.

Header HTTP kustom tidak didukung dalam operasi MCP. Hanya header sistem standar yang ditransmisikan.

Daftar alat tetap statis setelah pendaftaran awal. Untuk mengambil perubahan alat sisi server, Anda harus menghapus integrasi dan membuatnya kembali.

Pembuatan konektor mungkin gagal jika URI callback Amazon Quick tidak diizinkan terdaftar oleh penyedia pihak ketiga.

Masalah konektivitas server mengakibatkan kegagalan langsung tanpa mencoba lagi.

Step-up otorisasi tidak didukung. Jika server MCP memerlukan cakupan tambahan setelah otorisasi awal (HTTP 403 denganinsufficient_scope), maka Anda harus mengotorisasi ulang seluruh koneksi. Peningkatan izin tambahan tidak tersedia.

Penanganan lingkup memiliki batasan sebagai berikut:

Hanya Dynamic Client Registration (DCR) yang didukung untuk pendaftaran klien otomatis. Dokumen Metadata ID Klien tidak didukung.

Well-known Penemuan URI hanya menggunakan jalur root server. Path-specific lokasi metadata (penemuan penyisipan jalur) tidak didukung. Keterbatasan ini dapat mencegah penemuan server yang melayani metadata hanya pada URI khusus jalur.