@payloadcms/plugin-mcp 4.0.0-canary.1 → 4.0.0-canary.3

package/src/translations/languages/zh.ts

@@ -0,0 +1,36 @@
+import type { PluginLanguage } from '../types.js'
+
+export const zhTranslations = {
+  'plugin-mcp': {
+    apiKeyDescription: 'API 密钥控制 MCP 客户端可以访问哪些集合、资源、工具和提示词。',
+    apiKeys: 'API 密钥',
+    authentication: '身份验证',
+    description: '描述',
+    descriptionDescription: '描述 API 密钥的用途。',
+    dismiss: '关闭',
+    keepKeyPrivate: '请妥善保管你的密钥。',
+    keyPrivateDescription: '此密钥会让 MCP 访问你的内容。不要与他人共享！',
+    lastUsed: '上次使用',
+    manageAPIKeys: '管理 API 密钥',
+    mcp: 'MCP',
+    noAPIKeys: '没有 API 密钥',
+    operations: '操作',
+    overrideAccess: '覆盖访问控制',
+    overrideAccessDescription:
+      '启用后，此密钥执行的每个操作都会绕过 Payload 访问控制。除非有明确原因，否则请保持关闭。',
+    permissions: '权限',
+    permissionsDescription: '允许 MCP 客户端访问以下集合、工具、资源和提示词。',
+    prompts: '提示词',
+    resources: '资源',
+    server: '服务器',
+    title: '标题',
+    titleDescription: 'API 密钥的易识别名称。',
+    tools: '工具',
+    userDescription: 'MCP 将代表其操作的用户。',
+  },
+}
+
+export const zh: PluginLanguage = {
+  dateFNSKey: 'zh-CN',
+  translations: zhTranslations,
+}

package/src/translations/languages/zhTw.ts

@@ -0,0 +1,36 @@
+import type { PluginLanguage } from '../types.js'
+
+export const zhTwTranslations = {
+  'plugin-mcp': {
+    apiKeyDescription: 'API 金鑰控制 MCP 用戶端可以存取哪些集合、資源、工具和提示詞。',
+    apiKeys: 'API 金鑰',
+    authentication: '驗證',
+    description: '描述',
+    descriptionDescription: '描述 API 金鑰的用途。',
+    dismiss: '關閉',
+    keepKeyPrivate: '請妥善保管你的金鑰。',
+    keyPrivateDescription: '此金鑰會讓 MCP 存取你的內容。不要與他人分享！',
+    lastUsed: '上次使用',
+    manageAPIKeys: '管理 API 金鑰',
+    mcp: 'MCP',
+    noAPIKeys: '沒有 API 金鑰',
+    operations: '操作',
+    overrideAccess: '覆寫存取控制',
+    overrideAccessDescription:
+      '啟用後，此金鑰執行的每個操作都會略過 Payload 存取控制。除非有明確原因，否則請保持關閉。',
+    permissions: '權限',
+    permissionsDescription: '允許 MCP 用戶端存取以下集合、工具、資源和提示詞。',
+    prompts: '提示詞',
+    resources: '資源',
+    server: '伺服器',
+    title: '標題',
+    titleDescription: 'API 金鑰的易識別名稱。',
+    tools: '工具',
+    userDescription: 'MCP 將代表其操作的使用者。',
+  },
+}
+
+export const zhTw: PluginLanguage = {
+  dateFNSKey: 'zh-TW',
+  translations: zhTwTranslations,
+}

package/src/translations/types.ts

@@ -0,0 +1,34 @@
+import type { Language } from '@payloadcms/translations'
+
+import type { enTranslations } from './languages/en.js'
+
+export type PluginLanguage = Language<{
+  'plugin-mcp': {
+    apiKeyDescription: string
+    apiKeys: string
+    authentication: string
+    description: string
+    descriptionDescription: string
+    dismiss: string
+    keepKeyPrivate: string
+    keyPrivateDescription: string
+    lastUsed: string
+    manageAPIKeys: string
+    mcp: string
+    noAPIKeys: string
+    operations: string
+    overrideAccess: string
+    overrideAccessDescription: string
+    permissions: string
+    permissionsDescription: string
+    prompts: string
+    resources: string
+    server: string
+    title: string
+    titleDescription: string
+    tools: string
+    userDescription: string
+  }
+}>
+
+export type PluginDefaultTranslationsObject = typeof enTranslations

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
@@ -47,8 +48,10 @@ export type ClientMCPPluginConfig = {
   items: Array<{
     collectionSlug?: string
     configKey: string
-    description: string
+    description?: string
     globalSlug?: string
+    /** Admin-UI bucket for collection/global tools: built-in CRUD, auth, or custom. */
+    group?: 'auth' | 'custom' | 'operations'
     label: string
     type: 'collectionTool' | 'globalTool' | 'prompt' | 'resource' | 'tool'
   }>
@@ -96,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
@@ -110,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.
@@ -124,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
@@ -282,7 +287,10 @@ export type MCPAPIKeysDocAccessTree = {
  */
 export type MCPAPIKeysDoc = {
   access: MCPAPIKeysDocAccessTree
+  apiKey?: string
+  apiKeyIndex?: string
   id: DefaultDocumentIDType
+  lastUsed?: string
   overrideAccess?: boolean
   user: null | TypedUser
 }