Tentukan agen Anda

Konektor MCP

Hubungkan server MCP ke agen Anda untuk mengakses alat eksternal dan sumber data.

Claude Managed Agents mendukung koneksi server Model Context Protocol (MCP) ke agen Anda. Ini memberikan agen akses ke alat eksternal, sumber data, dan layanan melalui protokol standar.

Konfigurasi MCP dibagi menjadi dua langkah:

Pembuatan agen mendeklarasikan server MCP mana yang terhubung dengan agen, berdasarkan nama dan URL.
Pembuatan sesi menyediakan autentikasi untuk server tersebut dengan mereferensikan vault yang telah terdaftar sebelumnya.

Pemisahan ini menjaga rahasia tetap keluar dari definisi agen yang dapat digunakan kembali sambil memungkinkan setiap sesi untuk melakukan autentikasi dengan kredensial miliknya sendiri.

Semua permintaan API Managed Agents memerlukan header beta managed-agents-2026-04-01. SDK menetapkan header beta secara otomatis.

Deklarasikan server MCP pada agen

Tentukan server MCP dalam array mcp_servers saat membuat agen. Setiap server memerlukan type, name yang unik, dan url. Tidak ada token autentikasi yang disediakan pada tahap ini.

name yang Anda tetapkan dalam array server MCP digunakan untuk mereferensikan entri mcp_toolset dalam array alat.

agent_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "GitHub Assistant",
  "model": "claude-sonnet-4-6",
  "mcp_servers": [
    {
      "type": "url",
      "name": "github",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  ],
  "tools": [
    {"type": "agent_toolset_20260401"},
    {"type": "mcp_toolset", "mcp_server_name": "github"}
  ]
}
EOF
)
agent_id=$(jq -r '.id' <<<"$agent_response")

Toolset MCP secara default menggunakan kebijakan izin always_ask, yang memerlukan persetujuan pengguna sebelum setiap pemanggilan alat. Lihat kebijakan izin untuk mengonfigurasi perilaku ini.

Sediakan autentikasi saat pembuatan sesi

Saat memulai sesi, teruskan vault_ids untuk menyediakan kredensial untuk server MCP Anda. Vault adalah koleksi kredensial yang Anda daftarkan sekali dan referensikan berdasarkan ID. Lihat Autentikasi dengan vault untuk cara membuat vault dan mengelola kredensial.

session_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<EOF
{
  "agent": "$agent_id",
  "environment_id": "$environment_id",
  "vault_ids": ["$vault_id"]
}
EOF
)
session_id=$(jq -r '.id' <<<"$session_response")

Jika kredensial otorisasi yang disediakan dalam vault tidak valid, pembuatan sesi akan berhasil dan interaksi masih dimungkinkan. Acara session.error dipancarkan yang menjelaskan kegagalan autentikasi MCP. Anda dapat memutuskan apakah akan memblokir interaksi lebih lanjut pada kesalahan ini, memicu pembaruan kredensial, atau membiarkan sesi berlanjut tanpa MCP. Percobaan ulang autentikasi akan terjadi pada transisi session.status_idle ke session.status_running berikutnya. Lihat Aliran acara sesi untuk detail tentang mengonsumsi session.error dan acara lainnya.

Jenis server MCP yang didukung

Claude Managed Agents terhubung ke server MCP jarak jauh yang mengekspos titik akhir HTTP. Server harus mendukung transportasi HTTP yang dapat dialirkan dari protokol MCP.

Untuk informasi lebih lanjut tentang MCP dan membangun server MCP, lihat dokumentasi MCP.

Was this page helpful?

Deklarasikan server MCP pada agen

Tentukan server MCP dalam array mcp_servers saat membuat agen. Setiap server memerlukan type, name yang unik, dan url. Tidak ada token autentikasi yang disediakan pada tahap ini.

name yang Anda tetapkan dalam array server MCP digunakan untuk mereferensikan entri mcp_toolset dalam array alat.

agent_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "GitHub Assistant",
  "model": "claude-sonnet-4-6",
  "mcp_servers": [
    {
      "type": "url",
      "name": "github",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  ],
  "tools": [
    {"type": "agent_toolset_20260401"},
    {"type": "mcp_toolset", "mcp_server_name": "github"}
  ]
}
EOF
)
agent_id=$(jq -r '.id' <<<"$agent_response")

Toolset MCP secara default menggunakan kebijakan izin always_ask, yang memerlukan persetujuan pengguna sebelum setiap pemanggilan alat. Lihat kebijakan izin untuk mengonfigurasi perilaku ini.

Sediakan autentikasi saat pembuatan sesi

session_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<EOF
{
  "agent": "$agent_id",
  "environment_id": "$environment_id",
  "vault_ids": ["$vault_id"]
}
EOF
)
session_id=$(jq -r '.id' <<<"$session_response")