Paginate MCP tool results

instrumentele de listă a platformelor returnează o pagină la un moment dat. Dacă schema de intrare a unui instrument include size and cursor, continuă prin rezultatele sale prin trecerea returnat next_cursor La următorul apel.

Pagination loop

1. Apelați la instrumentul de listă fără cursor.
2. Citiți elementele din câmpul de rezultate specific instrumentului.
3. If the result includes next_cursor, apelaţi din nou acelaşi instrument cu acea valoare ca cursor.
4. Stop when next_cursor is absent.

Tratează valorile cursorului ca fiind opace. Nu le decoda, edita sau construi.

Example with listRisks

Primul apel include organizația și, opțional, o dimensiune a paginii:

{
  "organization_id": "organization-id",
  "size": 50
}

listRisks returns its items in risksCând o altă pagină este disponibilă, rezultatul include, de asemenea, next_cursor:

{
  "risks": [
    {
      "id": "risk-id",
      "name": "Unauthorized production access"
    }
  ],
  "next_cursor": "cursor-value"
}

Utilizați această valoare în următorul apel:

{
  "organization_id": "organization-id",
  "size": 50,
  "cursor": "cursor-value"
}

Continue until the result no longer includes next_cursor.

Keep the query unchanged

Păstrați organizarea, filtrele, ordinea și dimensiunea paginii neschimbate atunci când solicitați următoarea pagină:

{
  "organization_id": "organization-id",
  "size": 50,
  "filter": {
    "query": "access"
  },
  "cursor": "cursor-value"
}

Verificați schema de intrare a instrumentului în clientul MCP în loc să presupuneți că fiecare instrument de listă acceptă aceleași câmpuri.

Result fields differ by tool

Câmpul de colectare corespunde resurselor listate. de exemplu, listRisks returns risks, while listThirdParties returns thirdPartiesUtilizați schema de ieșire anunțată de server pentru a determina câmpul pentru un instrument specific.

Pentru sarcinile de lungă durată, procesați fiecare pagină înainte de a solicita următoarea, în loc să acumulați rezultatul complet setat în memorie.