@payloadcms/plugin-mcp 4.0.0-canary.2 → 4.0.0-internal.011fd46

package/src/translations/languages/sk.ts

@@ -2,23 +2,27 @@ import type { PluginLanguage } from '../types.js'
 
 export const skTranslations = {
   'plugin-mcp': {
-    apiKeyDescription: 'Kľúče API určujú, ku ktorým kolekciám, zdrojom, nástrojom a promptom majú klienti MCP prístup.',
+    apiKeyDescription:
+      'Kľúče API určujú, ku ktorým kolekciám, zdrojom, nástrojom a promptom majú klienti MCP prístup.',
     apiKeys: 'Kľúče API',
     authentication: 'Overenie',
     description: 'Popis',
     descriptionDescription: 'Opíšte účel kľúča API.',
     dismiss: 'Zavrieť',
     keepKeyPrivate: 'Udržujte svoj kľúč v súkromí.',
-    keyPrivateDescription: 'Tento kľúč dáva MCP prístup k vášmu obsahu. Nezdieľajte ho s ostatnými!',
+    keyPrivateDescription:
+      'Tento kľúč dáva MCP prístup k vášmu obsahu. Nezdieľajte ho s ostatnými!',
     lastUsed: 'Naposledy použité',
     manageAPIKeys: 'Spravovať kľúče API',
     mcp: 'MCP',
     noAPIKeys: 'Žiadne kľúče API',
     operations: 'Operácie',
     overrideAccess: 'Prepísať riadenie prístupu',
-    overrideAccessDescription: 'Ak je zaškrtnuté, tento kľúč obíde riadenie prístupu Payload pri každej operácii. Nechajte nezaškrtnuté, pokiaľ nemáte konkrétny dôvod.',
+    overrideAccessDescription:
+      'Ak je zaškrtnuté, tento kľúč obíde riadenie prístupu Payload pri každej operácii. Nechajte nezaškrtnuté, pokiaľ nemáte konkrétny dôvod.',
     permissions: 'Oprávnenia',
-    permissionsDescription: 'Povoľte klientom MCP prístup k nasledujúcim kolekciám, nástrojom, zdrojom a promptom.',
+    permissionsDescription:
+      'Povoľte klientom MCP prístup k nasledujúcim kolekciám, nástrojom, zdrojom a promptom.',
     prompts: 'Prompty',
     resources: 'Zdroje',
     server: 'Server',

package/src/translations/languages/sl.ts

@@ -2,7 +2,8 @@ import type { PluginLanguage } from '../types.js'
 
 export const slTranslations = {
   'plugin-mcp': {
-    apiKeyDescription: 'API ključi nadzorujejo, do katerih zbirk, virov, orodij in promptov lahko dostopajo odjemalci MCP.',
+    apiKeyDescription:
+      'API ključi nadzorujejo, do katerih zbirk, virov, orodij in promptov lahko dostopajo odjemalci MCP.',
     apiKeys: 'API ključi',
     authentication: 'Preverjanje pristnosti',
     description: 'Opis',
@@ -16,9 +17,11 @@ export const slTranslations = {
     noAPIKeys: 'Ni API ključev',
     operations: 'Operacije',
     overrideAccess: 'Prepiši nadzor dostopa',
-    overrideAccessDescription: 'Ko je označeno, ta ključ obide Payloadov nadzor dostopa pri vsaki operaciji. Pustite neoznačeno, razen če imate poseben razlog.',
+    overrideAccessDescription:
+      'Ko je označeno, ta ključ obide Payloadov nadzor dostopa pri vsaki operaciji. Pustite neoznačeno, razen če imate poseben razlog.',
     permissions: 'Dovoljenja',
-    permissionsDescription: 'Dovolite odjemalcem MCP dostop do naslednjih zbirk, orodij, virov in promptov.',
+    permissionsDescription:
+      'Dovolite odjemalcem MCP dostop do naslednjih zbirk, orodij, virov in promptov.',
     prompts: 'Prompti',
     resources: 'Viri',
     server: 'Strežnik',

package/src/translations/languages/sv.ts

@@ -2,23 +2,27 @@ import type { PluginLanguage } from '../types.js'
 
 export const svTranslations = {
   'plugin-mcp': {
-    apiKeyDescription: 'API-nycklar styr vilka samlingar, resurser, verktyg och prompter MCP-klienter kan komma åt.',
+    apiKeyDescription:
+      'API-nycklar styr vilka samlingar, resurser, verktyg och prompter MCP-klienter kan komma åt.',
     apiKeys: 'API-nycklar',
     authentication: 'Autentisering',
     description: 'Beskrivning',
     descriptionDescription: 'Beskriv syftet med API-nyckeln.',
     dismiss: 'Stäng',
     keepKeyPrivate: 'Håll din nyckel privat.',
-    keyPrivateDescription: 'Den här nyckeln ger MCP åtkomst till ditt innehåll. Dela den inte med andra!',
+    keyPrivateDescription:
+      'Den här nyckeln ger MCP åtkomst till ditt innehåll. Dela den inte med andra!',
     lastUsed: 'Senast använd',
     manageAPIKeys: 'Hantera API-nycklar',
     mcp: 'MCP',
     noAPIKeys: 'Inga API-nycklar',
     operations: 'Åtgärder',
     overrideAccess: 'Åsidosätt åtkomstkontroll',
-    overrideAccessDescription: 'När detta är markerat kringgår nyckeln Payloads åtkomstkontroll för varje åtgärd. Lämna avmarkerat om du inte har en specifik anledning.',
+    overrideAccessDescription:
+      'När detta är markerat kringgår nyckeln Payloads åtkomstkontroll för varje åtgärd. Lämna avmarkerat om du inte har en specifik anledning.',
     permissions: 'Behörigheter',
-    permissionsDescription: 'Tillåt MCP-klienter att komma åt följande samlingar, verktyg, resurser och prompter.',
+    permissionsDescription:
+      'Tillåt MCP-klienter att komma åt följande samlingar, verktyg, resurser och prompter.',
     prompts: 'Prompter',
     resources: 'Resurser',
     server: 'Server',

package/src/translations/languages/ta.ts

@@ -2,23 +2,27 @@ import type { PluginLanguage } from '../types.js'
 
 export const taTranslations = {
   'plugin-mcp': {
-    apiKeyDescription: 'MCP கிளையன்ட்கள் எந்த collections, resources, tools மற்றும் prompts-ஐ அணுகலாம் என்பதை API விசைகள் கட்டுப்படுத்துகின்றன.',
+    apiKeyDescription:
+      'MCP கிளையன்ட்கள் எந்த collections, resources, tools மற்றும் prompts-ஐ அணுகலாம் என்பதை API விசைகள் கட்டுப்படுத்துகின்றன.',
     apiKeys: 'API விசைகள்',
     authentication: 'அங்கீகாரம்',
     description: 'விளக்கம்',
     descriptionDescription: 'API விசையின் நோக்கத்தை விளக்குங்கள்.',
     dismiss: 'மூடு',
     keepKeyPrivate: 'உங்கள் விசையை தனிப்பட்டதாக வைத்திருங்கள்.',
-    keyPrivateDescription: 'இந்த விசை MCP-க்கு உங்கள் உள்ளடக்கத்தை அணுக அனுமதிக்கிறது. இதை பிறருடன் பகிர வேண்டாம்!',
+    keyPrivateDescription:
+      'இந்த விசை MCP-க்கு உங்கள் உள்ளடக்கத்தை அணுக அனுமதிக்கிறது. இதை பிறருடன் பகிர வேண்டாம்!',
     lastUsed: 'கடைசியாக பயன்படுத்தியது',
     manageAPIKeys: 'API விசைகளை நிர்வகி',
     mcp: 'MCP',
     noAPIKeys: 'API விசைகள் இல்லை',
     operations: 'செயல்பாடுகள்',
     overrideAccess: 'அணுகல் கட்டுப்பாட்டை மீறு',
-    overrideAccessDescription: 'இது தேர்ந்தெடுக்கப்பட்டால், இந்த விசை மேற்கொள்ளும் ஒவ்வொரு செயல்பாட்டிலும் Payload அணுகல் கட்டுப்பாட்டை மீறும். குறிப்பிட்ட காரணம் இல்லையெனில் தேர்வு செய்ய வேண்டாம்.',
+    overrideAccessDescription:
+      'இது தேர்ந்தெடுக்கப்பட்டால், இந்த விசை மேற்கொள்ளும் ஒவ்வொரு செயல்பாட்டிலும் Payload அணுகல் கட்டுப்பாட்டை மீறும். குறிப்பிட்ட காரணம் இல்லையெனில் தேர்வு செய்ய வேண்டாம்.',
     permissions: 'அனுமதிகள்',
-    permissionsDescription: 'MCP கிளையன்ட்களுக்கு பின்வரும் collections, tools, resources மற்றும் prompts-ஐ அணுக அனுமதிக்கவும்.',
+    permissionsDescription:
+      'MCP கிளையன்ட்களுக்கு பின்வரும் collections, tools, resources மற்றும் prompts-ஐ அணுக அனுமதிக்கவும்.',
     prompts: 'Prompts',
     resources: 'Resources',
     server: 'சேவையகம்',

package/src/translations/languages/th.ts

@@ -2,7 +2,8 @@ import type { PluginLanguage } from '../types.js'
 
 export const thTranslations = {
   'plugin-mcp': {
-    apiKeyDescription: 'คีย์ API ควบคุมว่าลูกค้า MCP สามารถเข้าถึงคอลเลกชัน ทรัพยากร เครื่องมือ และพรอมป์ใดได้บ้าง',
+    apiKeyDescription:
+      'คีย์ API ควบคุมว่าลูกค้า MCP สามารถเข้าถึงคอลเลกชัน ทรัพยากร เครื่องมือ และพรอมป์ใดได้บ้าง',
     apiKeys: 'คีย์ API',
     authentication: 'การยืนยันตัวตน',
     description: 'คำอธิบาย',
@@ -16,9 +17,11 @@ export const thTranslations = {
     noAPIKeys: 'ไม่มีคีย์ API',
     operations: 'การดำเนินการ',
     overrideAccess: 'ข้ามการควบคุมการเข้าถึง',
-    overrideAccessDescription: 'เมื่อเลือก คีย์นี้จะข้ามการควบคุมการเข้าถึงของ Payload ในทุกการดำเนินการ เว้นไว้หากไม่มีเหตุผลเฉพาะ',
+    overrideAccessDescription:
+      'เมื่อเลือก คีย์นี้จะข้ามการควบคุมการเข้าถึงของ Payload ในทุกการดำเนินการ เว้นไว้หากไม่มีเหตุผลเฉพาะ',
     permissions: 'สิทธิ์',
-    permissionsDescription: 'อนุญาตให้ลูกค้า MCP เข้าถึงคอลเลกชัน เครื่องมือ ทรัพยากร และพรอมป์ต่อไปนี้',
+    permissionsDescription:
+      'อนุญาตให้ลูกค้า MCP เข้าถึงคอลเลกชัน เครื่องมือ ทรัพยากร และพรอมป์ต่อไปนี้',
     prompts: 'พรอมป์',
     resources: 'ทรัพยากร',
     server: 'เซิร์ฟเวอร์',

package/src/translations/languages/tr.ts

@@ -2,7 +2,8 @@ import type { PluginLanguage } from '../types.js'
 
 export const trTranslations = {
   'plugin-mcp': {
-    apiKeyDescription: 'API anahtarları, MCP istemcilerinin hangi koleksiyonlara, kaynaklara, araçlara ve promptlara erişebileceğini kontrol eder.',
+    apiKeyDescription:
+      'API anahtarları, MCP istemcilerinin hangi koleksiyonlara, kaynaklara, araçlara ve promptlara erişebileceğini kontrol eder.',
     apiKeys: 'API anahtarları',
     authentication: 'Kimlik doğrulama',
     description: 'Açıklama',
@@ -16,9 +17,11 @@ export const trTranslations = {
     noAPIKeys: 'API anahtarı yok',
     operations: 'İşlemler',
     overrideAccess: 'Erişim kontrolünü geçersiz kıl',
-    overrideAccessDescription: 'İşaretlendiğinde bu anahtar, gerçekleştirdiği her işlemde Payload erişim kontrolünü atlar. Belirli bir nedeniniz yoksa işaretlemeyin.',
+    overrideAccessDescription:
+      'İşaretlendiğinde bu anahtar, gerçekleştirdiği her işlemde Payload erişim kontrolünü atlar. Belirli bir nedeniniz yoksa işaretlemeyin.',
     permissions: 'İzinler',
-    permissionsDescription: 'MCP istemcilerinin aşağıdaki koleksiyonlara, araçlara, kaynaklara ve promptlara erişmesine izin verin.',
+    permissionsDescription:
+      'MCP istemcilerinin aşağıdaki koleksiyonlara, araçlara, kaynaklara ve promptlara erişmesine izin verin.',
     prompts: 'Promptlar',
     resources: 'Kaynaklar',
     server: 'Sunucu',

package/src/translations/languages/uk.ts

@@ -2,23 +2,27 @@ import type { PluginLanguage } from '../types.js'
 
 export const ukTranslations = {
   'plugin-mcp': {
-    apiKeyDescription: 'API-ключі керують тим, до яких колекцій, ресурсів, інструментів і промптів можуть мати доступ MCP-клієнти.',
+    apiKeyDescription:
+      'API-ключі керують тим, до яких колекцій, ресурсів, інструментів і промптів можуть мати доступ MCP-клієнти.',
     apiKeys: 'API-ключі',
     authentication: 'Автентифікація',
     description: 'Опис',
     descriptionDescription: 'Опишіть призначення API-ключа.',
     dismiss: 'Закрити',
     keepKeyPrivate: 'Зберігайте ключ приватним.',
-    keyPrivateDescription: 'Цей ключ надає MCP доступ до вашого контенту. Не діліться ним з іншими!',
+    keyPrivateDescription:
+      'Цей ключ надає MCP доступ до вашого контенту. Не діліться ним з іншими!',
     lastUsed: 'Останнє використання',
     manageAPIKeys: 'Керувати API-ключами',
     mcp: 'MCP',
     noAPIKeys: 'Немає API-ключів',
     operations: 'Операції',
     overrideAccess: 'Перевизначити контроль доступу',
-    overrideAccessDescription: 'Якщо увімкнено, цей ключ обходить контроль доступу Payload під час кожної операції. Залиште вимкненим, якщо немає конкретної причини.',
+    overrideAccessDescription:
+      'Якщо увімкнено, цей ключ обходить контроль доступу Payload під час кожної операції. Залиште вимкненим, якщо немає конкретної причини.',
     permissions: 'Дозволи',
-    permissionsDescription: 'Дозвольте MCP-клієнтам доступ до таких колекцій, інструментів, ресурсів і промптів.',
+    permissionsDescription:
+      'Дозвольте MCP-клієнтам доступ до таких колекцій, інструментів, ресурсів і промптів.',
     prompts: 'Промпти',
     resources: 'Ресурси',
     server: 'Сервер',

package/src/translations/languages/vi.ts

@@ -2,23 +2,27 @@ import type { PluginLanguage } from '../types.js'
 
 export const viTranslations = {
   'plugin-mcp': {
-    apiKeyDescription: 'Khóa API kiểm soát các bộ sưu tập, tài nguyên, công cụ và prompt mà client MCP có thể truy cập.',
+    apiKeyDescription:
+      'Khóa API kiểm soát các bộ sưu tập, tài nguyên, công cụ và prompt mà client MCP có thể truy cập.',
     apiKeys: 'Khóa API',
     authentication: 'Xác thực',
     description: 'Mô tả',
     descriptionDescription: 'Mô tả mục đích của khóa API.',
     dismiss: 'Đóng',
     keepKeyPrivate: 'Giữ khóa của bạn riêng tư.',
-    keyPrivateDescription: 'Khóa này cấp cho MCP quyền truy cập nội dung của bạn. Đừng chia sẻ với người khác!',
+    keyPrivateDescription:
+      'Khóa này cấp cho MCP quyền truy cập nội dung của bạn. Đừng chia sẻ với người khác!',
     lastUsed: 'Lần dùng cuối',
     manageAPIKeys: 'Quản lý khóa API',
     mcp: 'MCP',
     noAPIKeys: 'Không có khóa API',
     operations: 'Thao tác',
     overrideAccess: 'Ghi đè kiểm soát truy cập',
-    overrideAccessDescription: 'Khi bật, khóa này bỏ qua kiểm soát truy cập của Payload trong mọi thao tác. Hãy để tắt trừ khi bạn có lý do cụ thể.',
+    overrideAccessDescription:
+      'Khi bật, khóa này bỏ qua kiểm soát truy cập của Payload trong mọi thao tác. Hãy để tắt trừ khi bạn có lý do cụ thể.',
     permissions: 'Quyền',
-    permissionsDescription: 'Cho phép client MCP truy cập các bộ sưu tập, công cụ, tài nguyên và prompt sau.',
+    permissionsDescription:
+      'Cho phép client MCP truy cập các bộ sưu tập, công cụ, tài nguyên và prompt sau.',
     prompts: 'Prompt',
     resources: 'Tài nguyên',
     server: 'Máy chủ',

package/src/translations/languages/zh.ts

@@ -16,7 +16,8 @@ export const zhTranslations = {
     noAPIKeys: '没有 API 密钥',
     operations: '操作',
     overrideAccess: '覆盖访问控制',
-    overrideAccessDescription: '启用后，此密钥执行的每个操作都会绕过 Payload 访问控制。除非有明确原因，否则请保持关闭。',
+    overrideAccessDescription:
+      '启用后，此密钥执行的每个操作都会绕过 Payload 访问控制。除非有明确原因，否则请保持关闭。',
     permissions: '权限',
     permissionsDescription: '允许 MCP 客户端访问以下集合、工具、资源和提示词。',
     prompts: '提示词',

package/src/translations/languages/zhTw.ts

@@ -16,7 +16,8 @@ export const zhTwTranslations = {
     noAPIKeys: '沒有 API 金鑰',
     operations: '操作',
     overrideAccess: '覆寫存取控制',
-    overrideAccessDescription: '啟用後，此金鑰執行的每個操作都會略過 Payload 存取控制。除非有明確原因，否則請保持關閉。',
+    overrideAccessDescription:
+      '啟用後，此金鑰執行的每個操作都會略過 Payload 存取控制。除非有明確原因，否則請保持關閉。',
     permissions: '權限',
     permissionsDescription: '允許 MCP 用戶端存取以下集合、工具、資源和提示詞。',
     prompts: '提示詞',

package/src/types.ts

@@ -6,6 +6,7 @@ import type {
   ResourceTemplate,
   ServerContext,
   StandardSchemaWithJSON,
+  ToolAnnotations,
 } from '@modelcontextprotocol/server'
 import type {
   AuthCollectionSlug,
@@ -26,8 +27,8 @@ import type {
 
 export type { MCPCollectionAuthToolName, MCPCollectionBuiltinName, MCPGlobalBuiltinName }
 
-/** Re-exported from `@modelcontextprotocol/server` — the JSON Schema shape the MCP runtime validates against. */
-export type { JsonSchemaType, StandardSchemaWithJSON }
+/** Re-exported from `@modelcontextprotocol/server` — common MCP types used in plugin config. */
+export type { JsonSchemaType, StandardSchemaWithJSON, ToolAnnotations }
 
 /**
  * What a tool's `input` (or a prompt's `argsSchema`) can be — either a raw
@@ -98,6 +99,7 @@ export type GlobalToolHandlerArgs<TSchema = undefined> = {
 } & ToolHandlerArgs<TSchema>
 
 export type Tool<TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined> = {
+  annotations?: ToolAnnotations
   description: string
   handler: (args: ToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>
   input?: TSchema
@@ -112,13 +114,13 @@ export type CollectionTool<
 > = {
   handler: (args: CollectionToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>
   input?: TSchema
-} & Pick<Tool, 'description' | 'overrideResponse'>
+} & Pick<Tool, 'annotations' | 'description' | 'overrideResponse'>
 
 export type GlobalTool<TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined> =
   {
     handler: (args: GlobalToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>
     input?: TSchema
-  } & Pick<Tool, 'description' | 'overrideResponse'>
+  } & Pick<Tool, 'annotations' | 'description' | 'overrideResponse'>
 
 /**
  * Configures (or disables) a built-in tool without replacing it.
@@ -126,6 +128,7 @@ export type GlobalTool<TSchema extends ToolInputSchema | undefined = ToolInputSc
  * required handler) from being silently accepted at a built-in key slot.
  */
 export type MCPBuiltInToolOverride = {
+  annotations?: ToolAnnotations
   description?: string
   handler?: never
   overrideResponse?: MCPResponseOverride