Referensi AWS Partner Central API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat [Referensi AWS Partner Central API](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Referensi Konfigurasi
<a name="mcp-configuration-reference"></a>

Halaman ini menyediakan referensi lengkap untuk menghubungkan dan mengonfigurasi Server MCP Agen Pusat Mitra.

## Titik akhir
<a name="mcp-config-endpoint"></a>


| Properti | Nilai | 
| --- | --- | 
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp | 
| Region | us-east-1(Virginia N.) hanya | 
| Protokol | JSON-RPC 2.0 melalui HTTPS | 
| Streaming | Server-Sent Acara (SSE) | 
| Autentikasi | AWS Versi Tanda Tangan 4 | 
| Nama layanan SiGv4 | partnercentral-agents-mcp | 
| Persyaratan TLS | TLS 1.2 atau lebih tinggi | 

## Izin IAM
<a name="mcp-config-iam-permissions"></a>

Semua tindakan IAM menggunakan `partnercentral:` awalan kecuali dinyatakan lain.

### Akses protokol MCP
<a name="mcp-config-protocol-access"></a>

Cara termudah untuk memberikan akses protokol MCP adalah dengan melampirkan kebijakan `AWSMcpServiceActionsFullAccess` terkelola ke identitas IAM Anda. Kebijakan ini mencakup semua izin yang diperlukan untuk berinteraksi dengan server MCP. Untuk kontrol halus, Anda dapat menggunakan kunci `aws:IsMcpServiceAction` kondisi dalam kebijakan IAM Anda untuk cakupan izin khusus untuk tindakan layanan MCP.


| Tindakan | Deskripsi | 
| --- | --- | 
| partnercentral:UseSession | Membuat, memperbarui, dan mengambil sesi percakapan | 

### Manajemen peluang
<a name="mcp-config-opportunity-management"></a>


| Tindakan | Deskripsi | 
| --- | --- | 
| partnercentral:List\* | Buat daftar peluang, solusi, dan sumber daya Pusat Mitra lainnya | 
| partnercentral:Get\* | Ambil detail untuk peluang individu dan sumber daya lainnya | 
| partnercentral:CreateOpportunity | Ciptakan peluang | 
| partnercentral:UpdateOpportunity | Ubah bidang peluang (tahap, tanggal tutup, pendapatan, dll.) | 
| partnercentral:SubmitOpportunity | Kirimkan kesempatan untuk AWS ditinjau | 
| partnercentral:AssignOpportunity | Tetapkan kesempatan kepada perwakilan mitra | 
| partnercentral:AssociateOpportunity | Tautkan peluang ke sumber daya lain (solusi, dll.) | 
| partnercentral:DisassociateOpportunity | Hapus tautan antara peluang dan sumber daya lain | 
| partnercentral:StartEngagementFromOpportunityTask | Kirimkan kesempatan untuk memulai keterlibatan dari sebuah kesempatan | 

### Program pendanaan
<a name="mcp-config-funding-programs"></a>


| Tindakan | Deskripsi | 
| --- | --- | 
| partnercentral:ListBenefitAllocations | Buat daftar alokasi manfaat yang tersedia untuk akun Anda | 
| partnercentral:ListBenefitApplications | Daftar aplikasi manfaat yang dikirimkan | 
| partnercentral:CreateBenefitApplication | Buat aplikasi manfaat baru (MAP, POC, WMP) | 
| partnercentral:GetBenefitApplication | Mengambil rincian aplikasi manfaat tertentu | 
| partnercentral:UpdateBenefitApplication | Perbarui aplikasi manfaat yang tertunda | 
| partnercentral:AssociateBenefitApplicationResource | Tautkan sumber daya ke aplikasi manfaat | 
| partnercentral:DisassociateBenefitApplicationResource | Hapus tautan sumber daya dari aplikasi manfaat | 

### Akses Marketplace
<a name="mcp-config-marketplace-access"></a>


| Tindakan | Deskripsi | 
| --- | --- | 
| aws-marketplace:DescribeEntity | Mengambil rincian entitas pasar | 
| aws-marketplace:SearchAgreements | Cari perjanjian pasar | 
| aws-marketplace:ListEntities | Daftar entitas pasar | 

### Agen Orientasi
<a name="mcp-config-onboarding-agent"></a>

**Manajemen akun mitra (`partnercentral`):**


| Tindakan | Deskripsi | 
| --- | --- | 
| partnercentral:ListPartners | Daftar pendaftaran mitra untuk akun | 
| partnercentral:GetPartner | Ambil registrasi mitra dan detail profil | 
| partnercentral:GetProfileVisibility | Ambil visibilitas profil saat ini () PUBLIC/PRIVATE | 
| partnercentral:GetAllianceLeadContact | Ambil informasi kontak pemimpin aliansi | 
| partnercentral:GetProfileUpdateTask | Periksa status pembaruan profil asinkron yang tertunda | 
| partnercentral:StartProfileUpdateTask | Kirim pembaruan profil mitra (async) | 
| partnercentral:CancelProfileUpdateTask | Membatalkan tugas pembaruan profil yang tertunda | 
| partnercentral:PutProfileVisibility | Ubah visibilitas profil menjadi PUBLIK atau PRIBADI | 
| partnercentral:PutAllianceLeadContact | Perbarui kontak utama aliansi (nama, judul, email) | 
| partnercentral:SendEmailVerificationCode | Kirim kode verifikasi untuk perubahan berbasis email domain/contact  | 
| partnercentral:AssociateAwsTrainingCertificationEmailDomain | Menautkan domain email untuk pelacakan sertifikasi pelatihan | 
| partnercentral:DisassociateAwsTrainingCertificationEmailDomain | Menghapus domain email sertifikasi pelatihan yang ditautkan | 
| partnercentral:GetAccountConnections | Buat daftar koneksi akun aktif (mis., Tautan anak perusahaan) | 
| partnercentral:GetConnectionInvitations | Daftar undangan koneksi terkirim dan terima yang tertunda | 
| partnercentral:CreateConnectionInvitation | Kirim undangan koneksi ke AWS akun lain | 
| partnercentral:CancelConnectionInvitation | Membatalkan undangan koneksi keluar yang tertunda | 
| partnercentral:RespondConnectionInvitation | Menerima atau menolak undangan koneksi masuk | 
| partnercentral:CancelConnection | Membatalkan koneksi akun aktif | 
| partnercentral:ManageConnectionPreferences | Dapatkan atau perbarui preferensi berbagi antar akun yang terhubung | 

**Pengaturan penjual Marketplace (`aws-marketplace`):**


| Tindakan | Deskripsi | 
| --- | --- | 
| aws-marketplace:ListEntities | Daftar entitas Marketplace (misalnya, entitas penjual) | 
| aws-marketplace:DescribeEntity | Mengambil rincian lengkap dari entitas Marketplace | 
| aws-marketplace:DescribeChangeSet | Memeriksa status set perubahan yang dikirimkan | 
| aws-marketplace:StartChangeSet | Kirim set perubahan Marketplace (mis., Pembaruan profil penjual) | 

**IAM — peran terkait layanan (): `iam`**


| Tindakan | Deskripsi | 
| --- | --- | 
| iam:GetRole | Periksa apakah peran terkait layanan Otorisasi Penjualan Kembali Marketplace ada | 
| iam:CreateServiceLinkedRole | Buat AWSServiceRoleForMarketplaceResaleAuthorization peran | 

## Lingkungan katalog
<a name="mcp-config-catalog-environments"></a>


| Katalog | Deskripsi | 
| --- | --- | 
| "AWS" | Lingkungan produksi. Semua operasi memengaruhi data mitra langsung. | 
| "Sandbox" | Lingkungan pengujian yang terisolasi. Tidak berdampak pada data produksi. Gunakan untuk pengembangan dan validasi. | 

## Manajemen sesi
<a name="mcp-config-session-management"></a>


| Properti | Nilai | 
| --- | --- | 
| Format ID Sesi | UUID v4 dengan session- awalan (mis.,) session-550e8400-e29b-41d4-a716-446655440000 | 
| Pembuatan sesi | Otomatis pada sendMessage panggilan pertama tanpa sessionId | 
| Kedaluwarsa sesi | 48 jam dari pembuatan sesi (kedaluwarsa absolut, bukan berbasis inaktivitas) | 

## Unggahan file
<a name="mcp-config-file-upload"></a>


| Properti | Nilai | 
| --- | --- | 
| Maks file per pesan | 3 | 
| Batas ukuran gambar | 3,75 MB | 
| Batas ukuran dokumen | 4,5 MB | 
| Ekstensi yang diizinkan | doc, docx, pdf, png, jpeg, xlsx, csv, txt | 
| Ember S3 (produksi) | aws-partner-central-marketplace-ephemeral-writeonly-file | 
| Unggah jalur | s3://{bucket}/{aws-account-id}/ | 
| Persyaratan URI S3 | Harus menyertakan parameter versionId kueri | 

### Unggah alur kerja
<a name="mcp-config-upload-workflow"></a>

1. Unggah file Anda ke bucket S3 yang sesuai di bawah awalan ID AWS akun Anda.

1. Perhatikan URI S3 termasuk yang `versionId` dikembalikan oleh unggahan.

1. Sertakan file sebagai blok `document` konten dalam `sendMessage` panggilan Anda.

Contoh format URI S3:

```
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
```

## Kode eror
<a name="mcp-config-error-codes"></a>


| Code | Nama | Deskripsi | 
| --- | --- | --- | 
| -32001 | AUTHENTICATION\_FAILURE | Sigv4 signature tidak valid atau kredensialnya telah kedaluwarsa | 
| -31004 | TOOL\_PERMISSION\_DENIED | Identitas IAM tidak memiliki partnercentral: tindakan yang diperlukan untuk operasi ini | 
| -32002 | ACCESS\_DENIED | Akses umum ditolak (akun tidak terdaftar, ketidakcocokan wilayah, dll.) | 
| -32004 | LIMIT\_EXCEEDED | Batas tarif atau kuota terlampaui. Coba lagi dengan backoff eksponensial. | 
| -30001 | RESOURCE\_NOT\_FOUND | Sumber daya yang diminta (sesi, peluang, dll.) Tidak ada | 
| -32600 | INVALID\_REQUEST |  JSON-RPC Permintaan cacat atau parameter tidak valid | 
| -32603 | INTERNAL\_ERROR | Server-side kesalahan. Coba lagi permintaannya. | 

## Batas tarif
<a name="mcp-config-rate-limits"></a>

Server memberlakukan batas tarif per akun:


| Operasi | Tingkat berkelanjutan | Burst | 
| --- | --- | --- | 
| sendMessage | 2 permintaan per menit | 10 | 
| Semua operasi lainnya | 10 permintaan per menit | 20 | 

Jika Anda melebihi batas ini, server mengembalikan kode kesalahan `-32004` (LIMIT\_EXCEEDEDED). Terapkan backoff eksponensial dengan jitter di klien Anda untuk menangani pembatasan laju dengan anggun.

## Jenis acara Streaming (SSE)
<a name="mcp-config-sse-events"></a>

Ketika `stream` diatur ke `true` dalam `sendMessage` panggilan, server mengembalikan Server-Sent Peristiwa dengan jenis acara ini:


| Jenis Acara | Deskripsi | 
| --- | --- | 
| stream\_start | Koneksi aliran dibuat | 
| assistant-response.start | Agen telah mulai menghasilkan respon | 
| assistant-response.delta | Potongan teks tambahan dari respons agen | 
| assistant-response.completed | Agen telah selesai menghasilkan respons | 
| server-tool-use | Agen menggunakan alat internal (operasi baca) | 
| server-tool-response | Hasil pemanggilan alat internal | 
| tool\_approval\_request | Agen meminta persetujuan manusia untuk operasi menulis | 
| stream\_end | Penutupan koneksi aliran | 
| done | Acara terakhir yang menunjukkan aliran SSE selesai | 

## Langkah selanjutnya
<a name="mcp-config-next-steps"></a>
+ [https://docs.aws.amazon.com/partner-central/latest/APIReference/mcp-tools-reference.html](https://docs.aws.amazon.com/partner-central/latest/APIReference/mcp-tools-reference.html) - Dokumentasi terperinci untuk `sendMessage` dan `getSession` alat