@payloadcms/plugin-mcp 4.0.0-canary.2 → 4.0.0-canary.20261117

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (529) hide show
  1. package/LICENSE.md +1 -1
  2. package/dist/defaultAccess.d.ts +3 -0
  3. package/dist/defaultAccess.d.ts.map +1 -0
  4. package/dist/defaultAccess.js +3 -0
  5. package/dist/defaultAccess.js.map +1 -0
  6. package/dist/defineTool.d.ts +8 -8
  7. package/dist/defineTool.d.ts.map +1 -1
  8. package/dist/endpoint/access.d.ts +29 -6
  9. package/dist/endpoint/access.d.ts.map +1 -1
  10. package/dist/endpoint/access.js +133 -100
  11. package/dist/endpoint/access.js.map +1 -1
  12. package/dist/endpoint/index.d.ts +1 -1
  13. package/dist/endpoint/index.d.ts.map +1 -1
  14. package/dist/endpoint/index.js +121 -16
  15. package/dist/endpoint/index.js.map +1 -1
  16. package/dist/endpoint/oauth.d.ts +37 -0
  17. package/dist/endpoint/oauth.d.ts.map +1 -0
  18. package/dist/endpoint/oauth.js +105 -0
  19. package/dist/endpoint/oauth.js.map +1 -0
  20. package/dist/endpoint/oauthLoginToken.d.ts +27 -0
  21. package/dist/endpoint/oauthLoginToken.d.ts.map +1 -0
  22. package/dist/endpoint/oauthLoginToken.js +86 -0
  23. package/dist/endpoint/oauthLoginToken.js.map +1 -0
  24. package/dist/endpoint/oauthServer.d.ts +28 -0
  25. package/dist/endpoint/oauthServer.d.ts.map +1 -0
  26. package/dist/endpoint/oauthServer.js +455 -0
  27. package/dist/endpoint/oauthServer.js.map +1 -0
  28. package/dist/exports/client.d.ts +1 -4
  29. package/dist/exports/client.d.ts.map +1 -1
  30. package/dist/exports/client.js +1 -4
  31. package/dist/exports/client.js.map +1 -1
  32. package/dist/exports/internal.d.ts +2 -0
  33. package/dist/exports/internal.d.ts.map +1 -0
  34. package/dist/exports/internal.js +3 -0
  35. package/dist/exports/internal.js.map +1 -0
  36. package/dist/exports/rsc.d.ts +2 -0
  37. package/dist/exports/rsc.d.ts.map +1 -0
  38. package/dist/exports/rsc.js +3 -0
  39. package/dist/exports/rsc.js.map +1 -0
  40. package/dist/index.d.ts +12 -4
  41. package/dist/index.d.ts.map +1 -1
  42. package/dist/index.js +31 -55
  43. package/dist/index.js.map +1 -1
  44. package/dist/mcp/buildMcpServer.d.ts +6 -6
  45. package/dist/mcp/buildMcpServer.d.ts.map +1 -1
  46. package/dist/mcp/buildMcpServer.js +70 -34
  47. package/dist/mcp/buildMcpServer.js.map +1 -1
  48. package/dist/mcp/builtin/collections/authTools.d.ts.map +1 -1
  49. package/dist/mcp/builtin/collections/authTools.js +123 -61
  50. package/dist/mcp/builtin/collections/authTools.js.map +1 -1
  51. package/dist/mcp/builtin/collections/countTool.d.ts +2 -0
  52. package/dist/mcp/builtin/collections/countTool.d.ts.map +1 -0
  53. package/dist/mcp/builtin/collections/countTool.js +63 -0
  54. package/dist/mcp/builtin/collections/countTool.js.map +1 -0
  55. package/dist/mcp/builtin/collections/countVersionsTool.d.ts +2 -0
  56. package/dist/mcp/builtin/collections/countVersionsTool.d.ts.map +1 -0
  57. package/dist/mcp/builtin/collections/countVersionsTool.js +60 -0
  58. package/dist/mcp/builtin/collections/countVersionsTool.js.map +1 -0
  59. package/dist/mcp/builtin/collections/createTool.d.ts +1 -1
  60. package/dist/mcp/builtin/collections/createTool.d.ts.map +1 -1
  61. package/dist/mcp/builtin/collections/createTool.js +109 -66
  62. package/dist/mcp/builtin/collections/createTool.js.map +1 -1
  63. package/dist/mcp/builtin/collections/deleteTool.d.ts.map +1 -1
  64. package/dist/mcp/builtin/collections/deleteTool.js +56 -45
  65. package/dist/mcp/builtin/collections/deleteTool.js.map +1 -1
  66. package/dist/mcp/builtin/collections/duplicateTool.d.ts +2 -0
  67. package/dist/mcp/builtin/collections/duplicateTool.d.ts.map +1 -0
  68. package/dist/mcp/builtin/collections/duplicateTool.js +90 -0
  69. package/dist/mcp/builtin/collections/duplicateTool.js.map +1 -0
  70. package/dist/mcp/builtin/collections/fileInput.d.ts +28 -0
  71. package/dist/mcp/builtin/collections/fileInput.d.ts.map +1 -0
  72. package/dist/mcp/builtin/collections/fileInput.js +88 -0
  73. package/dist/mcp/builtin/collections/fileInput.js.map +1 -0
  74. package/dist/mcp/builtin/collections/findDistinctTool.d.ts +2 -0
  75. package/dist/mcp/builtin/collections/findDistinctTool.d.ts.map +1 -0
  76. package/dist/mcp/builtin/collections/findDistinctTool.js +77 -0
  77. package/dist/mcp/builtin/collections/findDistinctTool.js.map +1 -0
  78. package/dist/mcp/builtin/collections/findTool.d.ts.map +1 -1
  79. package/dist/mcp/builtin/collections/findTool.js +58 -56
  80. package/dist/mcp/builtin/collections/findTool.js.map +1 -1
  81. package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts +2 -0
  82. package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts.map +1 -0
  83. package/dist/mcp/builtin/collections/findVersionByIDTool.js +74 -0
  84. package/dist/mcp/builtin/collections/findVersionByIDTool.js.map +1 -0
  85. package/dist/mcp/builtin/collections/findVersionsTool.d.ts +2 -0
  86. package/dist/mcp/builtin/collections/findVersionsTool.d.ts.map +1 -0
  87. package/dist/mcp/builtin/collections/findVersionsTool.js +84 -0
  88. package/dist/mcp/builtin/collections/findVersionsTool.js.map +1 -0
  89. package/dist/mcp/builtin/collections/getCollectionSchemaTool.d.ts.map +1 -1
  90. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js +78 -10
  91. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js.map +1 -1
  92. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts +2 -0
  93. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts.map +1 -0
  94. package/dist/mcp/builtin/collections/restoreVersionTool.js +69 -0
  95. package/dist/mcp/builtin/collections/restoreVersionTool.js.map +1 -0
  96. package/dist/mcp/builtin/collections/updateTool.d.ts.map +1 -1
  97. package/dist/mcp/builtin/collections/updateTool.js +75 -102
  98. package/dist/mcp/builtin/collections/updateTool.js.map +1 -1
  99. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts +2 -0
  100. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts.map +1 -0
  101. package/dist/mcp/builtin/collections/uploadInstructionsTool.js +55 -0
  102. package/dist/mcp/builtin/collections/uploadInstructionsTool.js.map +1 -0
  103. package/dist/mcp/builtin/formatEntityError.d.ts +16 -0
  104. package/dist/mcp/builtin/formatEntityError.d.ts.map +1 -0
  105. package/dist/mcp/builtin/formatEntityError.js +55 -0
  106. package/dist/mcp/builtin/formatEntityError.js.map +1 -0
  107. package/dist/mcp/builtin/getConfigInfoTool.d.ts.map +1 -1
  108. package/dist/mcp/builtin/getConfigInfoTool.js +30 -10
  109. package/dist/mcp/builtin/getConfigInfoTool.js.map +1 -1
  110. package/dist/mcp/builtin/globals/countVersionsTool.d.ts +2 -0
  111. package/dist/mcp/builtin/globals/countVersionsTool.d.ts.map +1 -0
  112. package/dist/mcp/builtin/globals/countVersionsTool.js +60 -0
  113. package/dist/mcp/builtin/globals/countVersionsTool.js.map +1 -0
  114. package/dist/mcp/builtin/globals/findTool.d.ts.map +1 -1
  115. package/dist/mcp/builtin/globals/findTool.js +26 -35
  116. package/dist/mcp/builtin/globals/findTool.js.map +1 -1
  117. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts +2 -0
  118. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts.map +1 -0
  119. package/dist/mcp/builtin/globals/findVersionByIDTool.js +68 -0
  120. package/dist/mcp/builtin/globals/findVersionByIDTool.js.map +1 -0
  121. package/dist/mcp/builtin/globals/findVersionsTool.d.ts +2 -0
  122. package/dist/mcp/builtin/globals/findVersionsTool.d.ts.map +1 -0
  123. package/dist/mcp/builtin/globals/findVersionsTool.js +78 -0
  124. package/dist/mcp/builtin/globals/findVersionsTool.js.map +1 -0
  125. package/dist/mcp/builtin/globals/getGlobalSchemaTool.d.ts.map +1 -1
  126. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js +56 -10
  127. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js.map +1 -1
  128. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts +2 -0
  129. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts.map +1 -0
  130. package/dist/mcp/builtin/globals/restoreVersionTool.js +70 -0
  131. package/dist/mcp/builtin/globals/restoreVersionTool.js.map +1 -0
  132. package/dist/mcp/builtin/globals/updateTool.d.ts.map +1 -1
  133. package/dist/mcp/builtin/globals/updateTool.js +38 -54
  134. package/dist/mcp/builtin/globals/updateTool.js.map +1 -1
  135. package/dist/mcp/builtinTools.d.ts +75 -12
  136. package/dist/mcp/builtinTools.d.ts.map +1 -1
  137. package/dist/mcp/builtinTools.js +75 -13
  138. package/dist/mcp/builtinTools.js.map +1 -1
  139. package/dist/mcp/sanitizeMCPConfig.d.ts +0 -1
  140. package/dist/mcp/sanitizeMCPConfig.d.ts.map +1 -1
  141. package/dist/mcp/sanitizeMCPConfig.js +76 -27
  142. package/dist/mcp/sanitizeMCPConfig.js.map +1 -1
  143. package/dist/stdio.d.ts +3 -3
  144. package/dist/stdio.d.ts.map +1 -1
  145. package/dist/stdio.js +86 -47
  146. package/dist/stdio.js.map +1 -1
  147. package/dist/types.d.ts +224 -95
  148. package/dist/types.d.ts.map +1 -1
  149. package/dist/types.js +2 -4
  150. package/dist/types.js.map +1 -1
  151. package/dist/utils/camelCase.d.ts.map +1 -1
  152. package/dist/utils/getPluginConfig.d.ts +1 -1
  153. package/dist/utils/getPluginConfig.js +1 -1
  154. package/dist/utils/getPluginConfig.js.map +1 -1
  155. package/dist/utils/resolveProjectRoot.d.ts.map +1 -1
  156. package/dist/utils/seal.d.ts +17 -0
  157. package/dist/utils/seal.d.ts.map +1 -0
  158. package/dist/utils/seal.js +24 -0
  159. package/dist/utils/seal.js.map +1 -0
  160. package/dist/utils/toStandardSchema.d.ts.map +1 -1
  161. package/dist/utils/toStandardSchema.js.map +1 -1
  162. package/dist/views/Authorize/AllowButtons/index.d.ts +18 -0
  163. package/dist/views/Authorize/AllowButtons/index.d.ts.map +1 -0
  164. package/dist/views/Authorize/AllowButtons/index.js +88 -0
  165. package/dist/views/Authorize/AllowButtons/index.js.map +1 -0
  166. package/dist/views/Authorize/index.css +19 -0
  167. package/dist/views/Authorize/index.d.ts +9 -0
  168. package/dist/views/Authorize/index.d.ts.map +1 -0
  169. package/dist/views/Authorize/index.js +98 -0
  170. package/dist/views/Authorize/index.js.map +1 -0
  171. package/package.json +34 -38
  172. package/src/defaultAccess.ts +3 -0
  173. package/src/endpoint/access.ts +149 -109
  174. package/src/endpoint/index.ts +103 -15
  175. package/src/endpoint/oauth.ts +108 -0
  176. package/src/endpoint/oauthLoginToken.ts +100 -0
  177. package/src/endpoint/oauthServer.ts +472 -0
  178. package/src/exports/client.ts +2 -4
  179. package/src/exports/internal.ts +1 -0
  180. package/src/exports/rsc.ts +1 -0
  181. package/src/index.ts +53 -63
  182. package/src/mcp/buildMcpServer.ts +88 -51
  183. package/src/mcp/builtin/collections/authTools.ts +124 -77
  184. package/src/mcp/builtin/collections/countTool.ts +61 -0
  185. package/src/mcp/builtin/collections/countVersionsTool.ts +60 -0
  186. package/src/mcp/builtin/collections/createTool.ts +113 -82
  187. package/src/mcp/builtin/collections/deleteTool.ts +49 -66
  188. package/src/mcp/builtin/collections/duplicateTool.ts +84 -0
  189. package/src/mcp/builtin/collections/fileInput.spec.ts +93 -0
  190. package/src/mcp/builtin/collections/fileInput.ts +127 -0
  191. package/src/mcp/builtin/collections/findDistinctTool.ts +67 -0
  192. package/src/mcp/builtin/collections/findTool.ts +54 -97
  193. package/src/mcp/builtin/collections/findVersionByIDTool.ts +66 -0
  194. package/src/mcp/builtin/collections/findVersionsTool.ts +83 -0
  195. package/src/mcp/builtin/collections/getCollectionSchemaTool.ts +70 -7
  196. package/src/mcp/builtin/collections/restoreVersionTool.ts +65 -0
  197. package/src/mcp/builtin/collections/updateTool.ts +72 -110
  198. package/src/mcp/builtin/collections/uploadInstructionsTool.ts +64 -0
  199. package/src/mcp/builtin/formatEntityError.ts +77 -0
  200. package/src/mcp/builtin/getConfigInfoTool.ts +29 -5
  201. package/src/mcp/builtin/globals/countVersionsTool.ts +60 -0
  202. package/src/mcp/builtin/globals/findTool.ts +27 -57
  203. package/src/mcp/builtin/globals/findVersionByIDTool.ts +64 -0
  204. package/src/mcp/builtin/globals/findVersionsTool.ts +69 -0
  205. package/src/mcp/builtin/globals/getGlobalSchemaTool.ts +52 -7
  206. package/src/mcp/builtin/globals/restoreVersionTool.ts +68 -0
  207. package/src/mcp/builtin/globals/updateTool.ts +49 -72
  208. package/src/mcp/builtinTools.ts +81 -18
  209. package/src/mcp/sanitizeMCPConfig.ts +53 -30
  210. package/src/stdio.ts +80 -47
  211. package/src/types.ts +232 -99
  212. package/src/utils/getPluginConfig.ts +1 -1
  213. package/src/utils/seal.ts +46 -0
  214. package/src/utils/toStandardSchema.ts +1 -1
  215. package/src/views/Authorize/AllowButtons/index.tsx +97 -0
  216. package/src/views/Authorize/index.css +19 -0
  217. package/src/views/Authorize/index.tsx +100 -0
  218. package/dist/collection/getAccessField.d.ts +0 -12
  219. package/dist/collection/getAccessField.d.ts.map +0 -1
  220. package/dist/collection/getAccessField.js +0 -72
  221. package/dist/collection/getAccessField.js.map +0 -1
  222. package/dist/collection/index.d.ts +0 -6
  223. package/dist/collection/index.d.ts.map +0 -1
  224. package/dist/collection/index.js +0 -105
  225. package/dist/collection/index.js.map +0 -1
  226. package/dist/components/APIKeyField/index.client.d.ts +0 -9
  227. package/dist/components/APIKeyField/index.client.d.ts.map +0 -1
  228. package/dist/components/APIKeyField/index.client.js +0 -85
  229. package/dist/components/APIKeyField/index.client.js.map +0 -1
  230. package/dist/components/APIKeyField/index.css +0 -105
  231. package/dist/components/APIKeysEmptyState/index.client.d.ts +0 -4
  232. package/dist/components/APIKeysEmptyState/index.client.d.ts.map +0 -1
  233. package/dist/components/APIKeysEmptyState/index.client.js +0 -21
  234. package/dist/components/APIKeysEmptyState/index.client.js.map +0 -1
  235. package/dist/components/AccessField/index.client.d.ts +0 -10
  236. package/dist/components/AccessField/index.client.d.ts.map +0 -1
  237. package/dist/components/AccessField/index.client.js +0 -247
  238. package/dist/components/AccessField/index.client.js.map +0 -1
  239. package/dist/components/AccessField/index.css +0 -99
  240. package/dist/components/SettingsMenu/index.client.d.ts +0 -8
  241. package/dist/components/SettingsMenu/index.client.d.ts.map +0 -1
  242. package/dist/components/SettingsMenu/index.client.js +0 -29
  243. package/dist/components/SettingsMenu/index.client.js.map +0 -1
  244. package/dist/mcp/builtin/collections/formatCollectionError.d.ts +0 -9
  245. package/dist/mcp/builtin/collections/formatCollectionError.d.ts.map +0 -1
  246. package/dist/mcp/builtin/collections/formatCollectionError.js +0 -60
  247. package/dist/mcp/builtin/collections/formatCollectionError.js.map +0 -1
  248. package/dist/mcp/builtin/validateEntityData.d.ts +0 -14
  249. package/dist/mcp/builtin/validateEntityData.d.ts.map +0 -1
  250. package/dist/mcp/builtin/validateEntityData.js +0 -82
  251. package/dist/mcp/builtin/validateEntityData.js.map +0 -1
  252. package/dist/translations/index.d.ts +0 -11
  253. package/dist/translations/index.d.ts.map +0 -1
  254. package/dist/translations/index.js +0 -92
  255. package/dist/translations/index.js.map +0 -1
  256. package/dist/translations/languages/ar.d.ts +0 -31
  257. package/dist/translations/languages/ar.d.ts.map +0 -1
  258. package/dist/translations/languages/ar.js +0 -34
  259. package/dist/translations/languages/ar.js.map +0 -1
  260. package/dist/translations/languages/az.d.ts +0 -31
  261. package/dist/translations/languages/az.d.ts.map +0 -1
  262. package/dist/translations/languages/az.js +0 -34
  263. package/dist/translations/languages/az.js.map +0 -1
  264. package/dist/translations/languages/bg.d.ts +0 -31
  265. package/dist/translations/languages/bg.d.ts.map +0 -1
  266. package/dist/translations/languages/bg.js +0 -34
  267. package/dist/translations/languages/bg.js.map +0 -1
  268. package/dist/translations/languages/bnBd.d.ts +0 -31
  269. package/dist/translations/languages/bnBd.d.ts.map +0 -1
  270. package/dist/translations/languages/bnBd.js +0 -34
  271. package/dist/translations/languages/bnBd.js.map +0 -1
  272. package/dist/translations/languages/bnIn.d.ts +0 -31
  273. package/dist/translations/languages/bnIn.d.ts.map +0 -1
  274. package/dist/translations/languages/bnIn.js +0 -34
  275. package/dist/translations/languages/bnIn.js.map +0 -1
  276. package/dist/translations/languages/ca.d.ts +0 -31
  277. package/dist/translations/languages/ca.d.ts.map +0 -1
  278. package/dist/translations/languages/ca.js +0 -34
  279. package/dist/translations/languages/ca.js.map +0 -1
  280. package/dist/translations/languages/cs.d.ts +0 -31
  281. package/dist/translations/languages/cs.d.ts.map +0 -1
  282. package/dist/translations/languages/cs.js +0 -34
  283. package/dist/translations/languages/cs.js.map +0 -1
  284. package/dist/translations/languages/da.d.ts +0 -31
  285. package/dist/translations/languages/da.d.ts.map +0 -1
  286. package/dist/translations/languages/da.js +0 -34
  287. package/dist/translations/languages/da.js.map +0 -1
  288. package/dist/translations/languages/de.d.ts +0 -31
  289. package/dist/translations/languages/de.d.ts.map +0 -1
  290. package/dist/translations/languages/de.js +0 -34
  291. package/dist/translations/languages/de.js.map +0 -1
  292. package/dist/translations/languages/en.d.ts +0 -31
  293. package/dist/translations/languages/en.d.ts.map +0 -1
  294. package/dist/translations/languages/en.js +0 -34
  295. package/dist/translations/languages/en.js.map +0 -1
  296. package/dist/translations/languages/es.d.ts +0 -31
  297. package/dist/translations/languages/es.d.ts.map +0 -1
  298. package/dist/translations/languages/es.js +0 -34
  299. package/dist/translations/languages/es.js.map +0 -1
  300. package/dist/translations/languages/et.d.ts +0 -31
  301. package/dist/translations/languages/et.d.ts.map +0 -1
  302. package/dist/translations/languages/et.js +0 -34
  303. package/dist/translations/languages/et.js.map +0 -1
  304. package/dist/translations/languages/fa.d.ts +0 -31
  305. package/dist/translations/languages/fa.d.ts.map +0 -1
  306. package/dist/translations/languages/fa.js +0 -34
  307. package/dist/translations/languages/fa.js.map +0 -1
  308. package/dist/translations/languages/fr.d.ts +0 -31
  309. package/dist/translations/languages/fr.d.ts.map +0 -1
  310. package/dist/translations/languages/fr.js +0 -34
  311. package/dist/translations/languages/fr.js.map +0 -1
  312. package/dist/translations/languages/he.d.ts +0 -31
  313. package/dist/translations/languages/he.d.ts.map +0 -1
  314. package/dist/translations/languages/he.js +0 -34
  315. package/dist/translations/languages/he.js.map +0 -1
  316. package/dist/translations/languages/hr.d.ts +0 -31
  317. package/dist/translations/languages/hr.d.ts.map +0 -1
  318. package/dist/translations/languages/hr.js +0 -34
  319. package/dist/translations/languages/hr.js.map +0 -1
  320. package/dist/translations/languages/hu.d.ts +0 -31
  321. package/dist/translations/languages/hu.d.ts.map +0 -1
  322. package/dist/translations/languages/hu.js +0 -34
  323. package/dist/translations/languages/hu.js.map +0 -1
  324. package/dist/translations/languages/hy.d.ts +0 -31
  325. package/dist/translations/languages/hy.d.ts.map +0 -1
  326. package/dist/translations/languages/hy.js +0 -34
  327. package/dist/translations/languages/hy.js.map +0 -1
  328. package/dist/translations/languages/id.d.ts +0 -31
  329. package/dist/translations/languages/id.d.ts.map +0 -1
  330. package/dist/translations/languages/id.js +0 -34
  331. package/dist/translations/languages/id.js.map +0 -1
  332. package/dist/translations/languages/is.d.ts +0 -31
  333. package/dist/translations/languages/is.d.ts.map +0 -1
  334. package/dist/translations/languages/is.js +0 -34
  335. package/dist/translations/languages/is.js.map +0 -1
  336. package/dist/translations/languages/it.d.ts +0 -31
  337. package/dist/translations/languages/it.d.ts.map +0 -1
  338. package/dist/translations/languages/it.js +0 -34
  339. package/dist/translations/languages/it.js.map +0 -1
  340. package/dist/translations/languages/ja.d.ts +0 -31
  341. package/dist/translations/languages/ja.d.ts.map +0 -1
  342. package/dist/translations/languages/ja.js +0 -34
  343. package/dist/translations/languages/ja.js.map +0 -1
  344. package/dist/translations/languages/ko.d.ts +0 -31
  345. package/dist/translations/languages/ko.d.ts.map +0 -1
  346. package/dist/translations/languages/ko.js +0 -34
  347. package/dist/translations/languages/ko.js.map +0 -1
  348. package/dist/translations/languages/lt.d.ts +0 -31
  349. package/dist/translations/languages/lt.d.ts.map +0 -1
  350. package/dist/translations/languages/lt.js +0 -34
  351. package/dist/translations/languages/lt.js.map +0 -1
  352. package/dist/translations/languages/lv.d.ts +0 -31
  353. package/dist/translations/languages/lv.d.ts.map +0 -1
  354. package/dist/translations/languages/lv.js +0 -34
  355. package/dist/translations/languages/lv.js.map +0 -1
  356. package/dist/translations/languages/my.d.ts +0 -31
  357. package/dist/translations/languages/my.d.ts.map +0 -1
  358. package/dist/translations/languages/my.js +0 -34
  359. package/dist/translations/languages/my.js.map +0 -1
  360. package/dist/translations/languages/nb.d.ts +0 -31
  361. package/dist/translations/languages/nb.d.ts.map +0 -1
  362. package/dist/translations/languages/nb.js +0 -34
  363. package/dist/translations/languages/nb.js.map +0 -1
  364. package/dist/translations/languages/nl.d.ts +0 -31
  365. package/dist/translations/languages/nl.d.ts.map +0 -1
  366. package/dist/translations/languages/nl.js +0 -34
  367. package/dist/translations/languages/nl.js.map +0 -1
  368. package/dist/translations/languages/pl.d.ts +0 -31
  369. package/dist/translations/languages/pl.d.ts.map +0 -1
  370. package/dist/translations/languages/pl.js +0 -34
  371. package/dist/translations/languages/pl.js.map +0 -1
  372. package/dist/translations/languages/pt.d.ts +0 -31
  373. package/dist/translations/languages/pt.d.ts.map +0 -1
  374. package/dist/translations/languages/pt.js +0 -34
  375. package/dist/translations/languages/pt.js.map +0 -1
  376. package/dist/translations/languages/ro.d.ts +0 -31
  377. package/dist/translations/languages/ro.d.ts.map +0 -1
  378. package/dist/translations/languages/ro.js +0 -34
  379. package/dist/translations/languages/ro.js.map +0 -1
  380. package/dist/translations/languages/rs.d.ts +0 -31
  381. package/dist/translations/languages/rs.d.ts.map +0 -1
  382. package/dist/translations/languages/rs.js +0 -34
  383. package/dist/translations/languages/rs.js.map +0 -1
  384. package/dist/translations/languages/rsLatin.d.ts +0 -31
  385. package/dist/translations/languages/rsLatin.d.ts.map +0 -1
  386. package/dist/translations/languages/rsLatin.js +0 -34
  387. package/dist/translations/languages/rsLatin.js.map +0 -1
  388. package/dist/translations/languages/ru.d.ts +0 -31
  389. package/dist/translations/languages/ru.d.ts.map +0 -1
  390. package/dist/translations/languages/ru.js +0 -34
  391. package/dist/translations/languages/ru.js.map +0 -1
  392. package/dist/translations/languages/sk.d.ts +0 -31
  393. package/dist/translations/languages/sk.d.ts.map +0 -1
  394. package/dist/translations/languages/sk.js +0 -34
  395. package/dist/translations/languages/sk.js.map +0 -1
  396. package/dist/translations/languages/sl.d.ts +0 -31
  397. package/dist/translations/languages/sl.d.ts.map +0 -1
  398. package/dist/translations/languages/sl.js +0 -34
  399. package/dist/translations/languages/sl.js.map +0 -1
  400. package/dist/translations/languages/sv.d.ts +0 -31
  401. package/dist/translations/languages/sv.d.ts.map +0 -1
  402. package/dist/translations/languages/sv.js +0 -34
  403. package/dist/translations/languages/sv.js.map +0 -1
  404. package/dist/translations/languages/ta.d.ts +0 -31
  405. package/dist/translations/languages/ta.d.ts.map +0 -1
  406. package/dist/translations/languages/ta.js +0 -34
  407. package/dist/translations/languages/ta.js.map +0 -1
  408. package/dist/translations/languages/th.d.ts +0 -31
  409. package/dist/translations/languages/th.d.ts.map +0 -1
  410. package/dist/translations/languages/th.js +0 -34
  411. package/dist/translations/languages/th.js.map +0 -1
  412. package/dist/translations/languages/tr.d.ts +0 -31
  413. package/dist/translations/languages/tr.d.ts.map +0 -1
  414. package/dist/translations/languages/tr.js +0 -34
  415. package/dist/translations/languages/tr.js.map +0 -1
  416. package/dist/translations/languages/uk.d.ts +0 -31
  417. package/dist/translations/languages/uk.d.ts.map +0 -1
  418. package/dist/translations/languages/uk.js +0 -34
  419. package/dist/translations/languages/uk.js.map +0 -1
  420. package/dist/translations/languages/vi.d.ts +0 -31
  421. package/dist/translations/languages/vi.d.ts.map +0 -1
  422. package/dist/translations/languages/vi.js +0 -34
  423. package/dist/translations/languages/vi.js.map +0 -1
  424. package/dist/translations/languages/zh.d.ts +0 -31
  425. package/dist/translations/languages/zh.d.ts.map +0 -1
  426. package/dist/translations/languages/zh.js +0 -34
  427. package/dist/translations/languages/zh.js.map +0 -1
  428. package/dist/translations/languages/zhTw.d.ts +0 -31
  429. package/dist/translations/languages/zhTw.d.ts.map +0 -1
  430. package/dist/translations/languages/zhTw.js +0 -34
  431. package/dist/translations/languages/zhTw.js.map +0 -1
  432. package/dist/translations/types.d.ts +0 -32
  433. package/dist/translations/types.d.ts.map +0 -1
  434. package/dist/translations/types.js +0 -3
  435. package/dist/translations/types.js.map +0 -1
  436. package/dist/utils/getVirtualFieldNames.d.ts +0 -14
  437. package/dist/utils/getVirtualFieldNames.d.ts.map +0 -1
  438. package/dist/utils/getVirtualFieldNames.js +0 -35
  439. package/dist/utils/getVirtualFieldNames.js.map +0 -1
  440. package/dist/utils/localAPIDefaults.d.ts +0 -20
  441. package/dist/utils/localAPIDefaults.d.ts.map +0 -1
  442. package/dist/utils/localAPIDefaults.js +0 -19
  443. package/dist/utils/localAPIDefaults.js.map +0 -1
  444. package/dist/utils/schemaConversion/getEntityInputSchema.d.ts +0 -11
  445. package/dist/utils/schemaConversion/getEntityInputSchema.d.ts.map +0 -1
  446. package/dist/utils/schemaConversion/getEntityInputSchema.js +0 -34
  447. package/dist/utils/schemaConversion/getEntityInputSchema.js.map +0 -1
  448. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts +0 -7
  449. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts.map +0 -1
  450. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js +0 -20
  451. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js.map +0 -1
  452. package/dist/utils/schemaConversion/sanitizeEntitySchema.d.ts +0 -15
  453. package/dist/utils/schemaConversion/sanitizeEntitySchema.d.ts.map +0 -1
  454. package/dist/utils/schemaConversion/sanitizeEntitySchema.js +0 -464
  455. package/dist/utils/schemaConversion/sanitizeEntitySchema.js.map +0 -1
  456. package/dist/utils/schemaConversion/sanitizeEntitySchema.spec.js +0 -158
  457. package/dist/utils/schemaConversion/sanitizeEntitySchema.spec.js.map +0 -1
  458. package/dist/utils/transformPointDataToPayload.d.ts +0 -7
  459. package/dist/utils/transformPointDataToPayload.d.ts.map +0 -1
  460. package/dist/utils/transformPointDataToPayload.js +0 -28
  461. package/dist/utils/transformPointDataToPayload.js.map +0 -1
  462. package/dist/utils/whereSchema.d.ts +0 -9
  463. package/dist/utils/whereSchema.d.ts.map +0 -1
  464. package/dist/utils/whereSchema.js +0 -13
  465. package/dist/utils/whereSchema.js.map +0 -1
  466. package/src/collection/getAccessField.ts +0 -84
  467. package/src/collection/index.ts +0 -105
  468. package/src/components/APIKeyField/index.client.tsx +0 -73
  469. package/src/components/APIKeyField/index.css +0 -105
  470. package/src/components/APIKeysEmptyState/index.client.tsx +0 -36
  471. package/src/components/AccessField/index.client.tsx +0 -299
  472. package/src/components/AccessField/index.css +0 -99
  473. package/src/components/SettingsMenu/index.client.tsx +0 -34
  474. package/src/mcp/builtin/collections/formatCollectionError.ts +0 -84
  475. package/src/mcp/builtin/validateEntityData.ts +0 -132
  476. package/src/translations/index.ts +0 -108
  477. package/src/translations/languages/ar.ts +0 -35
  478. package/src/translations/languages/az.ts +0 -35
  479. package/src/translations/languages/bg.ts +0 -35
  480. package/src/translations/languages/bnBd.ts +0 -35
  481. package/src/translations/languages/bnIn.ts +0 -35
  482. package/src/translations/languages/ca.ts +0 -35
  483. package/src/translations/languages/cs.ts +0 -35
  484. package/src/translations/languages/da.ts +0 -35
  485. package/src/translations/languages/de.ts +0 -35
  486. package/src/translations/languages/en.ts +0 -35
  487. package/src/translations/languages/es.ts +0 -35
  488. package/src/translations/languages/et.ts +0 -35
  489. package/src/translations/languages/fa.ts +0 -35
  490. package/src/translations/languages/fr.ts +0 -35
  491. package/src/translations/languages/he.ts +0 -35
  492. package/src/translations/languages/hr.ts +0 -35
  493. package/src/translations/languages/hu.ts +0 -35
  494. package/src/translations/languages/hy.ts +0 -35
  495. package/src/translations/languages/id.ts +0 -35
  496. package/src/translations/languages/is.ts +0 -35
  497. package/src/translations/languages/it.ts +0 -35
  498. package/src/translations/languages/ja.ts +0 -35
  499. package/src/translations/languages/ko.ts +0 -35
  500. package/src/translations/languages/lt.ts +0 -35
  501. package/src/translations/languages/lv.ts +0 -35
  502. package/src/translations/languages/my.ts +0 -35
  503. package/src/translations/languages/nb.ts +0 -35
  504. package/src/translations/languages/nl.ts +0 -35
  505. package/src/translations/languages/pl.ts +0 -35
  506. package/src/translations/languages/pt.ts +0 -35
  507. package/src/translations/languages/ro.ts +0 -35
  508. package/src/translations/languages/rs.ts +0 -35
  509. package/src/translations/languages/rsLatin.ts +0 -35
  510. package/src/translations/languages/ru.ts +0 -35
  511. package/src/translations/languages/sk.ts +0 -35
  512. package/src/translations/languages/sl.ts +0 -35
  513. package/src/translations/languages/sv.ts +0 -35
  514. package/src/translations/languages/ta.ts +0 -35
  515. package/src/translations/languages/th.ts +0 -35
  516. package/src/translations/languages/tr.ts +0 -35
  517. package/src/translations/languages/uk.ts +0 -35
  518. package/src/translations/languages/vi.ts +0 -35
  519. package/src/translations/languages/zh.ts +0 -35
  520. package/src/translations/languages/zhTw.ts +0 -35
  521. package/src/translations/types.ts +0 -34
  522. package/src/utils/getVirtualFieldNames.ts +0 -53
  523. package/src/utils/localAPIDefaults.ts +0 -22
  524. package/src/utils/schemaConversion/getEntityInputSchema.ts +0 -78
  525. package/src/utils/schemaConversion/removeVirtualFieldsFromSchema.ts +0 -27
  526. package/src/utils/schemaConversion/sanitizeEntitySchema.spec.ts +0 -103
  527. package/src/utils/schemaConversion/sanitizeEntitySchema.ts +0 -529
  528. package/src/utils/transformPointDataToPayload.ts +0 -40
  529. package/src/utils/whereSchema.ts +0 -24
package/LICENSE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2018-2024 Payload CMS, Inc. <info@payloadcms.com>
3
+ Copyright (c) 2018-2026 Payload CMS, LLC <info@payloadcms.com>
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining
6
6
  a copy of this software and associated documentation files (the
@@ -0,0 +1,3 @@
1
+ import type { MCPAccessArgs } from './types.js';
2
+ export declare const defaultAccess: ({ req }: MCPAccessArgs) => boolean;
3
+ //# sourceMappingURL=defaultAccess.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defaultAccess.d.ts","sourceRoot":"","sources":["../src/defaultAccess.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,eAAO,MAAM,aAAa,YAAa,aAAa,KAAG,OAA4B,CAAA"}
@@ -0,0 +1,3 @@
1
+ export const defaultAccess = ({ req })=>Boolean(req.user);
2
+
3
+ //# sourceMappingURL=defaultAccess.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/defaultAccess.ts"],"sourcesContent":["import type { MCPAccessArgs } from './types.js'\n\nexport const defaultAccess = ({ req }: MCPAccessArgs): boolean => Boolean(req.user)\n"],"names":["defaultAccess","req","Boolean","user"],"mappings":"AAEA,OAAO,MAAMA,gBAAgB,CAAC,EAAEC,GAAG,EAAiB,GAAcC,QAAQD,IAAIE,IAAI,EAAC"}
@@ -11,16 +11,16 @@ import type { CollectionTool, GlobalTool, Prompt, Tool, ToolInputSchema } from '
11
11
  * Config and handler signatures are derived from `Tool` / `CollectionTool` / `GlobalTool` /
12
12
  * `Prompt` via `Omit` + indexed access so there's no duplication with `types.ts`.
13
13
  */
14
- export declare const defineTool: <TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined>(args: Omit<Tool<TSchema>, "handler">) => {
15
- handler: (fn: Tool<TSchema>["handler"]) => Tool;
14
+ export declare const defineTool: <TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined>(args: Omit<Tool<TSchema>, 'handler'>) => {
15
+ handler: (fn: Tool<TSchema>['handler']) => Tool;
16
16
  };
17
- export declare const defineCollectionTool: <TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined>(args: Omit<CollectionTool<TSchema>, "handler">) => {
18
- handler: (fn: CollectionTool<TSchema>["handler"]) => CollectionTool;
17
+ export declare const defineCollectionTool: <TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined>(args: Omit<CollectionTool<TSchema>, 'handler'>) => {
18
+ handler: (fn: CollectionTool<TSchema>['handler']) => CollectionTool;
19
19
  };
20
- export declare const defineGlobalTool: <TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined>(args: Omit<GlobalTool<TSchema>, "handler">) => {
21
- handler: (fn: GlobalTool<TSchema>["handler"]) => GlobalTool;
20
+ export declare const defineGlobalTool: <TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined>(args: Omit<GlobalTool<TSchema>, 'handler'>) => {
21
+ handler: (fn: GlobalTool<TSchema>['handler']) => GlobalTool;
22
22
  };
23
- export declare const definePrompt: <TSchema extends ToolInputSchema = ToolInputSchema>(args: Omit<Prompt<TSchema>, "handler">) => {
24
- handler: (fn: Prompt<TSchema>["handler"]) => Prompt;
23
+ export declare const definePrompt: <TSchema extends ToolInputSchema = ToolInputSchema>(args: Omit<Prompt<TSchema>, 'handler'>) => {
24
+ handler: (fn: Prompt<TSchema>['handler']) => Prompt;
25
25
  };
26
26
  //# sourceMappingURL=defineTool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"defineTool.d.ts","sourceRoot":"","sources":["../src/defineTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE3F;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,UAAU,GACrB,OAAO,SAAS,eAAe,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,EAEzE,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KACnC;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,IAAI,CAAA;CAElD,CAAA;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,eAAe,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,EAEzE,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KAC7C;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,cAAc,CAAA;CAEtE,CAAA;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,SAAS,eAAe,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,EAEzE,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KACzC;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,UAAU,CAAA;CAE9D,CAAA;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,eAAe,GAAG,eAAe,EAC5E,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KACrC;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,MAAM,CAAA;CAEtD,CAAA"}
1
+ {"version":3,"file":"defineTool.d.ts","sourceRoot":"","sources":["../src/defineTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE3F;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,UAAU,GACrB,OAAO,SAAS,eAAe,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,QAEnE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KACnC;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,IAAI,CAAA;CAElD,CAAA;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,eAAe,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,QAEnE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KAC7C;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,cAAc,CAAA;CAEtE,CAAA;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,SAAS,eAAe,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,QAEnE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KACzC;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,UAAU,CAAA;CAE9D,CAAA;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,eAAe,GAAG,eAAe,QACtE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KACrC;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,MAAM,CAAA;CAEtD,CAAA"}
@@ -1,10 +1,33 @@
1
- import type { PayloadRequest } from 'payload';
2
- import type { AuthorizedMCP } from '../types.js';
1
+ import type { PayloadRequest, SanitizedPermissions } from 'payload';
2
+ import type { AuthorizedMCP, MCPItem } from '../types.js';
3
+ export type GetAuthorizedMCPArgs = {
4
+ /**
5
+ * Whether the request came through the HTTP endpoint, whose response can carry the OAuth
6
+ * challenge and headers from auth strategies. stdio has no response to carry them.
7
+ */
8
+ isHTTP?: boolean;
9
+ overrideAccess: boolean;
10
+ req: PayloadRequest;
11
+ };
12
+ /**
13
+ * Authenticates an MCP request, rejects users the plugin's `access` denies, and removes items the
14
+ * user cannot access. `overrideAccess` skips Payload and MCP access checks.
15
+ */
16
+ export declare const getAuthorizedMCP: (args: GetAuthorizedMCPArgs) => Promise<AuthorizedMCP>;
3
17
  /**
4
- * Resolves the API key (or dev-mode session) and returns the items the caller
5
- * may use. Denied items are dropped from the array.
18
+ * Runs the plugin's top-level `access`, which decides whether the user can use MCP at all. Doesn't
19
+ * check `overrideAccess`, so callers skip it themselves.
6
20
  */
7
- export declare const getAuthorizedMCP: (args: {
21
+ export declare const canUseMCP: ({ permissions, req, }: {
22
+ /** Computed when missing and `access` is set. */
23
+ permissions?: SanitizedPermissions;
24
+ req: PayloadRequest;
25
+ }) => Promise<boolean>;
26
+ export declare const filterMCPItems: ({ items, overrideAccess, permissions: providedPermissions, req, }: {
27
+ items: MCPItem[];
28
+ overrideAccess: boolean;
29
+ /** Computed when missing. */
30
+ permissions?: SanitizedPermissions;
8
31
  req: PayloadRequest;
9
- }) => Promise<AuthorizedMCP>;
32
+ }) => Promise<MCPItem[]>;
10
33
  //# sourceMappingURL=access.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/endpoint/access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,cAAc,EAAa,MAAM,SAAS,CAAA;AAK/E,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAA;AAK/D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,cAAc,CAAA;CAAE,KAAK,OAAO,CAAC,aAAa,CAiDtF,CAAA"}
1
+ {"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/endpoint/access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAKnE,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAKzD,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,OAAO,CAAA;IACvB,GAAG,EAAE,cAAc,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,aAAa,CA6EnF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,0BAGnB;IACD,iDAAiD;IACjD,WAAW,CAAC,EAAE,oBAAoB,CAAA;IAClC,GAAG,EAAE,cAAc,CAAA;CACpB,KAAG,OAAO,CAAC,OAAO,CAOlB,CAAA;AAED,eAAO,MAAM,cAAc,sEAKxB;IACD,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,cAAc,EAAE,OAAO,CAAA;IACvB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,oBAAoB,CAAA;IAClC,GAAG,EAAE,cAAc,CAAA;CACpB,KAAG,OAAO,CAAC,OAAO,EAAE,CAkBpB,CAAA"}
@@ -1,122 +1,155 @@
1
- import crypto from 'crypto';
2
- import { UnauthorizedError } from 'payload';
3
- import { getLogger } from '../utils/getLogger.js';
1
+ import { executeAuthStrategies, Forbidden, getAccessResults, UnauthorizedError } from 'payload';
2
+ import { extractBearerToken } from 'payload/shared';
4
3
  import { getPluginConfig } from '../utils/getPluginConfig.js';
4
+ import { authenticateLoginToken } from './oauthLoginToken.js';
5
5
  /**
6
- * Resolves the API key (or dev-mode session) and returns the items the caller
7
- * may use. Denied items are dropped from the array.
8
- */ export const getAuthorizedMCP = async ({ req })=>{
9
- const logger = getLogger({
10
- payload: req.payload
11
- });
6
+ * Authenticates an MCP request, rejects users the plugin's `access` denies, and removes items the
7
+ * user cannot access. `overrideAccess` skips Payload and MCP access checks.
8
+ */ export const getAuthorizedMCP = async ({ isHTTP = false, overrideAccess, req })=>{
12
9
  const pluginConfig = getPluginConfig({
13
10
  config: req.payload.config
14
11
  });
15
- const authHeader = req.headers.get('Authorization');
16
- const hasBearerToken = authHeader?.startsWith('Bearer ');
17
- const buildAuthorized = (apiKeyDoc)=>({
18
- items: pluginConfig.items.filter((item)=>{
19
- switch(item.type){
20
- case 'collectionTool':
21
- return apiKeyDoc.access.collections?.[item.collectionSlug]?.[item.configKey] !== false;
22
- case 'globalTool':
23
- return apiKeyDoc.access.globals?.[item.globalSlug]?.[item.configKey] !== false;
24
- case 'prompt':
25
- return apiKeyDoc.access.prompts?.[item.configKey] !== false;
26
- case 'resource':
27
- return apiKeyDoc.access.resources?.[item.configKey] !== false;
28
- case 'tool':
29
- return apiKeyDoc.access.tools?.[item.configKey] !== false;
30
- }
31
- }),
32
- overrideAccess: typeof apiKeyDoc.overrideAccess === 'boolean' ? apiKeyDoc.overrideAccess : false,
33
- user: apiKeyDoc.user
34
- });
35
- if (pluginConfig.overrideAuth) {
36
- return await pluginConfig.overrideAuth({
37
- getAPIKeyDoc: (overrideApiKey)=>getAPIKeyDoc({
38
- logger,
39
- overrideApiKey,
40
- pluginConfig,
41
- req
42
- }),
43
- getAuthorizedMCP: ({ apiKeyDoc })=>buildAuthorized(apiKeyDoc),
12
+ const isChallengedWhenSignedOut = isHTTP && Boolean(pluginConfig.oauth);
13
+ if (pluginConfig.overrideGetAuthorizedMCP) {
14
+ return await pluginConfig.overrideGetAuthorizedMCP({
15
+ overrideAccess,
44
16
  pluginConfig,
45
17
  req
46
18
  });
47
19
  }
48
- if (process.env.NODE_ENV === 'development' && !hasBearerToken) {
49
- logger.info('Dev mode: skipping API key check, using session user');
50
- return buildAuthorized({
51
- id: -1,
52
- access: {},
53
- overrideAccess: true,
54
- user: req.user ?? null
20
+ if (req.headers) {
21
+ const headers = new Headers(req.headers);
22
+ const hasAuthorization = headers.has('Authorization');
23
+ headers.set('DisableAutologin', 'true');
24
+ // Not `payload.auth()`, which also computes permissions that filterMCPItems computes anyway
25
+ const { responseHeaders, user } = await executeAuthStrategies({
26
+ canSetHeaders: isHTTP,
27
+ headers,
28
+ payload: req.payload,
29
+ req
30
+ });
31
+ req.user = user;
32
+ if (responseHeaders) {
33
+ req.responseHeaders = responseHeaders;
34
+ }
35
+ // Only bearer tokens that no auth strategy accepted get here, e.g. an OAuth access token.
36
+ // API keys use the `<collection> API-Key <key>` scheme instead of `Bearer`, so they never do.
37
+ const bearerToken = extractBearerToken({
38
+ headers
55
39
  });
40
+ // Sealed Payload login tokens from the built-in OAuth server
41
+ if (!req.user && bearerToken && pluginConfig.oauth?.type === 'builtin' && !pluginConfig.oauth.issueToken) {
42
+ req.user = await authenticateLoginToken({
43
+ req,
44
+ token: bearerToken
45
+ });
46
+ }
47
+ if (!req.user && bearerToken && pluginConfig.oauth?.authenticate) {
48
+ req.user = await pluginConfig.oauth.authenticate({
49
+ req,
50
+ token: bearerToken
51
+ });
52
+ }
53
+ // With OAuth, the endpoint answers with a challenge that starts the client's sign-in
54
+ if (hasAuthorization && !req.user && !isChallengedWhenSignedOut) {
55
+ throw new UnauthorizedError(req.t);
56
+ }
56
57
  }
57
- return buildAuthorized(await getAPIKeyDoc({
58
- logger,
59
- pluginConfig,
58
+ // Signed-out users only get the challenge, so they can't use any MCP items. Skipping the access
59
+ // checks saves work, and access callbacks only see signed-in users.
60
+ if (isChallengedWhenSignedOut && !req.user) {
61
+ return {
62
+ items: [],
63
+ overrideAccess
64
+ };
65
+ }
66
+ // Computed once for the plugin's `access` and every item's
67
+ const permissions = overrideAccess ? undefined : await getAccessResults({
60
68
  req
61
- }));
62
- };
63
- const getAPIKeyDoc = async ({ logger, overrideApiKey, pluginConfig, req })=>{
64
- const authHeader = req.headers.get('Authorization');
65
- const hasBearerToken = authHeader?.startsWith('Bearer ');
66
- const apiKey = overrideApiKey ?? (hasBearerToken ? authHeader?.replace('Bearer ', '').trim() || null : null);
67
- if (!apiKey) {
68
- throw new UnauthorizedError();
69
+ });
70
+ if (!overrideAccess && !await canUseMCP({
71
+ permissions,
72
+ req
73
+ })) {
74
+ throw new Forbidden(req.t);
69
75
  }
70
- const sha256APIKeyIndex = crypto.createHmac('sha256', req.payload.secret).update(apiKey).digest('hex');
71
- const doc = await req.payload.db.findOne({
72
- collection: 'payload-mcp-api-keys',
73
- req,
74
- where: {
75
- apiKeyIndex: {
76
- equals: sha256APIKeyIndex
77
- }
78
- }
76
+ return {
77
+ items: await filterMCPItems({
78
+ items: pluginConfig.items,
79
+ overrideAccess,
80
+ permissions,
81
+ req
82
+ }),
83
+ overrideAccess
84
+ };
85
+ };
86
+ /**
87
+ * Runs the plugin's top-level `access`, which decides whether the user can use MCP at all. Doesn't
88
+ * check `overrideAccess`, so callers skip it themselves.
89
+ */ export const canUseMCP = async ({ permissions, req })=>{
90
+ const { access } = getPluginConfig({
91
+ config: req.payload.config
92
+ });
93
+ return !access || await access({
94
+ permissions: permissions ?? await getAccessResults({
95
+ req
96
+ }),
97
+ req
79
98
  });
80
- if (!doc || !doc.user) {
81
- throw new UnauthorizedError();
99
+ };
100
+ export const filterMCPItems = async ({ items, overrideAccess, permissions: providedPermissions, req })=>{
101
+ // Match Payload core: overrideAccess bypasses access evaluation
102
+ if (overrideAccess) {
103
+ return items;
82
104
  }
83
- logger.info('API Key is valid');
84
- const userRef = doc.user;
85
- const userID = typeof userRef === 'object' && userRef !== null && 'id' in userRef ? userRef.id : userRef;
86
- const user = await req.payload.findByID({
87
- id: userID,
88
- collection: pluginConfig.userCollection,
89
- depth: 0,
90
- disableErrors: true,
105
+ const authorizedItems = [];
106
+ const permissions = providedPermissions ?? await getAccessResults({
91
107
  req
92
108
  });
93
- if (!user) {
94
- throw new UnauthorizedError();
109
+ for (const item of items){
110
+ if (!await checkItemAccess({
111
+ item,
112
+ permissions,
113
+ req
114
+ })) {
115
+ continue;
116
+ }
117
+ authorizedItems.push(item);
95
118
  }
96
- try {
97
- await req.payload.db.updateOne({
98
- id: doc.id,
99
- collection: 'payload-mcp-api-keys',
100
- data: {
101
- lastUsed: new Date().toISOString()
102
- },
103
- req,
104
- returning: false
105
- });
106
- } catch (err) {
107
- logger.warn({
108
- err,
109
- msg: 'Failed to update MCP API key last-used timestamp'
110
- });
119
+ return authorizedItems;
120
+ };
121
+ /**
122
+ * Runs MCP item access callbacks
123
+ */ const checkItemAccess = async ({ item, permissions, req })=>{
124
+ switch(item.type){
125
+ case 'collectionTool':
126
+ return !item.tool.access || await item.tool.access({
127
+ slug: item.collectionSlug,
128
+ permissions,
129
+ req
130
+ });
131
+ case 'globalTool':
132
+ return !item.tool.access || await item.tool.access({
133
+ slug: item.globalSlug,
134
+ permissions,
135
+ req
136
+ });
137
+ case 'prompt':
138
+ return !item.prompt.access || await item.prompt.access({
139
+ permissions,
140
+ req
141
+ });
142
+ case 'resource':
143
+ return !item.resource.access || await item.resource.access({
144
+ permissions,
145
+ req
146
+ });
147
+ case 'tool':
148
+ return !item.tool.access || await item.tool.access({
149
+ permissions,
150
+ req
151
+ });
111
152
  }
112
- return {
113
- ...doc,
114
- user: {
115
- ...user,
116
- _strategy: 'mcp-api-key',
117
- collection: pluginConfig.userCollection
118
- }
119
- };
120
153
  };
121
154
 
122
155
  //# sourceMappingURL=access.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/endpoint/access.ts"],"sourcesContent":["import type { DefaultDocumentIDType, PayloadRequest, TypedUser } from 'payload'\n\nimport crypto from 'crypto'\nimport { UnauthorizedError } from 'payload'\n\nimport type { AuthorizedMCP, MCPAPIKeysDoc } from '../types.js'\n\nimport { getLogger } from '../utils/getLogger.js'\nimport { getPluginConfig } from '../utils/getPluginConfig.js'\n\n/**\n * Resolves the API key (or dev-mode session) and returns the items the caller\n * may use. Denied items are dropped from the array.\n */\nexport const getAuthorizedMCP: (args: { req: PayloadRequest }) => Promise<AuthorizedMCP> = async ({\n req,\n}) => {\n const logger = getLogger({ payload: req.payload })\n const pluginConfig = getPluginConfig({ config: req.payload.config })\n\n const authHeader = req.headers.get('Authorization')\n const hasBearerToken = authHeader?.startsWith('Bearer ')\n\n const buildAuthorized = (apiKeyDoc: MCPAPIKeysDoc): AuthorizedMCP => ({\n items: pluginConfig.items.filter((item) => {\n switch (item.type) {\n case 'collectionTool':\n return apiKeyDoc.access.collections?.[item.collectionSlug]?.[item.configKey] !== false\n case 'globalTool':\n return apiKeyDoc.access.globals?.[item.globalSlug]?.[item.configKey] !== false\n case 'prompt':\n return apiKeyDoc.access.prompts?.[item.configKey] !== false\n case 'resource':\n return apiKeyDoc.access.resources?.[item.configKey] !== false\n case 'tool':\n return apiKeyDoc.access.tools?.[item.configKey] !== false\n }\n }),\n overrideAccess:\n typeof apiKeyDoc.overrideAccess === 'boolean' ? apiKeyDoc.overrideAccess : false,\n user: apiKeyDoc.user,\n })\n\n if (pluginConfig.overrideAuth) {\n return await pluginConfig.overrideAuth({\n getAPIKeyDoc: (overrideApiKey) => getAPIKeyDoc({ logger, overrideApiKey, pluginConfig, req }),\n getAuthorizedMCP: ({ apiKeyDoc }) => buildAuthorized(apiKeyDoc),\n pluginConfig,\n req,\n })\n }\n\n if (process.env.NODE_ENV === 'development' && !hasBearerToken) {\n logger.info('Dev mode: skipping API key check, using session user')\n return buildAuthorized({\n id: -1,\n access: {},\n overrideAccess: true,\n user: req.user ?? null,\n })\n }\n\n return buildAuthorized(await getAPIKeyDoc({ logger, pluginConfig, req }))\n}\n\nconst getAPIKeyDoc = async ({\n logger,\n overrideApiKey,\n pluginConfig,\n req,\n}: {\n logger: ReturnType<typeof getLogger>\n overrideApiKey?: string\n pluginConfig: ReturnType<typeof getPluginConfig>\n req: PayloadRequest\n}): Promise<MCPAPIKeysDoc> => {\n const authHeader = req.headers.get('Authorization')\n const hasBearerToken = authHeader?.startsWith('Bearer ')\n\n const apiKey =\n overrideApiKey ?? (hasBearerToken ? authHeader?.replace('Bearer ', '').trim() || null : null)\n\n if (!apiKey) {\n throw new UnauthorizedError()\n }\n\n const sha256APIKeyIndex = crypto\n .createHmac('sha256', req.payload.secret)\n .update(apiKey)\n .digest('hex')\n\n const doc = await req.payload.db.findOne<MCPAPIKeysDoc>({\n collection: 'payload-mcp-api-keys',\n req,\n where: {\n apiKeyIndex: { equals: sha256APIKeyIndex },\n },\n })\n\n if (!doc || !doc.user) {\n throw new UnauthorizedError()\n }\n\n logger.info('API Key is valid')\n\n const userRef = doc.user\n const userID =\n typeof userRef === 'object' && userRef !== null && 'id' in userRef\n ? userRef.id\n : (userRef as unknown as DefaultDocumentIDType)\n\n const user = (await req.payload.findByID({\n id: userID,\n collection: pluginConfig.userCollection,\n depth: 0,\n disableErrors: true,\n req,\n })) as null | TypedUser\n\n if (!user) {\n throw new UnauthorizedError()\n }\n\n try {\n await req.payload.db.updateOne({\n id: doc.id,\n collection: 'payload-mcp-api-keys',\n data: { lastUsed: new Date().toISOString() },\n req,\n returning: false,\n })\n } catch (err) {\n logger.warn({ err, msg: 'Failed to update MCP API key last-used timestamp' })\n }\n\n return {\n ...doc,\n user: {\n ...user,\n _strategy: 'mcp-api-key' as const,\n collection: pluginConfig.userCollection,\n },\n }\n}\n"],"names":["crypto","UnauthorizedError","getLogger","getPluginConfig","getAuthorizedMCP","req","logger","payload","pluginConfig","config","authHeader","headers","get","hasBearerToken","startsWith","buildAuthorized","apiKeyDoc","items","filter","item","type","access","collections","collectionSlug","configKey","globals","globalSlug","prompts","resources","tools","overrideAccess","user","overrideAuth","getAPIKeyDoc","overrideApiKey","process","env","NODE_ENV","info","id","apiKey","replace","trim","sha256APIKeyIndex","createHmac","secret","update","digest","doc","db","findOne","collection","where","apiKeyIndex","equals","userRef","userID","findByID","userCollection","depth","disableErrors","updateOne","data","lastUsed","Date","toISOString","returning","err","warn","msg","_strategy"],"mappings":"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"}
1
+ {"version":3,"sources":["../../src/endpoint/access.ts"],"sourcesContent":["import type { PayloadRequest, SanitizedPermissions } from 'payload'\n\nimport { executeAuthStrategies, Forbidden, getAccessResults, UnauthorizedError } from 'payload'\nimport { extractBearerToken } from 'payload/shared'\n\nimport type { AuthorizedMCP, MCPItem } from '../types.js'\n\nimport { getPluginConfig } from '../utils/getPluginConfig.js'\nimport { authenticateLoginToken } from './oauthLoginToken.js'\n\nexport type GetAuthorizedMCPArgs = {\n /**\n * Whether the request came through the HTTP endpoint, whose response can carry the OAuth\n * challenge and headers from auth strategies. stdio has no response to carry them.\n */\n isHTTP?: boolean\n overrideAccess: boolean\n req: PayloadRequest\n}\n\n/**\n * Authenticates an MCP request, rejects users the plugin's `access` denies, and removes items the\n * user cannot access. `overrideAccess` skips Payload and MCP access checks.\n */\nexport const getAuthorizedMCP: (args: GetAuthorizedMCPArgs) => Promise<AuthorizedMCP> = async ({\n isHTTP = false,\n overrideAccess,\n req,\n}) => {\n const pluginConfig = getPluginConfig({ config: req.payload.config })\n const isChallengedWhenSignedOut = isHTTP && Boolean(pluginConfig.oauth)\n\n if (pluginConfig.overrideGetAuthorizedMCP) {\n return await pluginConfig.overrideGetAuthorizedMCP({\n overrideAccess,\n pluginConfig,\n req,\n })\n }\n\n if (req.headers) {\n const headers = new Headers(req.headers)\n const hasAuthorization = headers.has('Authorization')\n\n headers.set('DisableAutologin', 'true')\n // Not `payload.auth()`, which also computes permissions that filterMCPItems computes anyway\n const { responseHeaders, user } = await executeAuthStrategies({\n canSetHeaders: isHTTP,\n headers,\n payload: req.payload,\n req,\n })\n req.user = user\n if (responseHeaders) {\n req.responseHeaders = responseHeaders\n }\n\n // Only bearer tokens that no auth strategy accepted get here, e.g. an OAuth access token.\n // API keys use the `<collection> API-Key <key>` scheme instead of `Bearer`, so they never do.\n const bearerToken = extractBearerToken({ headers })\n // Sealed Payload login tokens from the built-in OAuth server\n if (\n !req.user &&\n bearerToken &&\n pluginConfig.oauth?.type === 'builtin' &&\n !pluginConfig.oauth.issueToken\n ) {\n req.user = await authenticateLoginToken({ req, token: bearerToken })\n }\n if (!req.user && bearerToken && pluginConfig.oauth?.authenticate) {\n req.user = await pluginConfig.oauth.authenticate({ req, token: bearerToken })\n }\n\n // With OAuth, the endpoint answers with a challenge that starts the client's sign-in\n if (hasAuthorization && !req.user && !isChallengedWhenSignedOut) {\n throw new UnauthorizedError(req.t)\n }\n }\n\n // Signed-out users only get the challenge, so they can't use any MCP items. Skipping the access\n // checks saves work, and access callbacks only see signed-in users.\n if (isChallengedWhenSignedOut && !req.user) {\n return { items: [], overrideAccess }\n }\n\n // Computed once for the plugin's `access` and every item's\n const permissions = overrideAccess ? undefined : await getAccessResults({ req })\n\n if (!overrideAccess && !(await canUseMCP({ permissions, req }))) {\n throw new Forbidden(req.t)\n }\n\n return {\n items: await filterMCPItems({\n items: pluginConfig.items,\n overrideAccess,\n permissions,\n req,\n }),\n overrideAccess,\n }\n}\n\n/**\n * Runs the plugin's top-level `access`, which decides whether the user can use MCP at all. Doesn't\n * check `overrideAccess`, so callers skip it themselves.\n */\nexport const canUseMCP = async ({\n permissions,\n req,\n}: {\n /** Computed when missing and `access` is set. */\n permissions?: SanitizedPermissions\n req: PayloadRequest\n}): Promise<boolean> => {\n const { access } = getPluginConfig({ config: req.payload.config })\n\n return (\n !access ||\n (await access({ permissions: permissions ?? (await getAccessResults({ req })), req }))\n )\n}\n\nexport const filterMCPItems = async ({\n items,\n overrideAccess,\n permissions: providedPermissions,\n req,\n}: {\n items: MCPItem[]\n overrideAccess: boolean\n /** Computed when missing. */\n permissions?: SanitizedPermissions\n req: PayloadRequest\n}): Promise<MCPItem[]> => {\n // Match Payload core: overrideAccess bypasses access evaluation\n if (overrideAccess) {\n return items\n }\n\n const authorizedItems: MCPItem[] = []\n\n const permissions = providedPermissions ?? (await getAccessResults({ req }))\n\n for (const item of items) {\n if (!(await checkItemAccess({ item, permissions, req }))) {\n continue\n }\n authorizedItems.push(item)\n }\n\n return authorizedItems\n}\n\n/**\n * Runs MCP item access callbacks\n */\nconst checkItemAccess = async ({\n item,\n permissions,\n req,\n}: {\n item: MCPItem\n permissions?: SanitizedPermissions\n req: PayloadRequest\n}): Promise<boolean> => {\n switch (item.type) {\n case 'collectionTool':\n return (\n !item.tool.access ||\n (await item.tool.access({ slug: item.collectionSlug, permissions, req }))\n )\n case 'globalTool':\n return (\n !item.tool.access || (await item.tool.access({ slug: item.globalSlug, permissions, req }))\n )\n case 'prompt':\n return !item.prompt.access || (await item.prompt.access({ permissions, req }))\n case 'resource':\n return !item.resource.access || (await item.resource.access({ permissions, req }))\n case 'tool':\n return !item.tool.access || (await item.tool.access({ permissions, req }))\n }\n}\n"],"names":["executeAuthStrategies","Forbidden","getAccessResults","UnauthorizedError","extractBearerToken","getPluginConfig","authenticateLoginToken","getAuthorizedMCP","isHTTP","overrideAccess","req","pluginConfig","config","payload","isChallengedWhenSignedOut","Boolean","oauth","overrideGetAuthorizedMCP","headers","Headers","hasAuthorization","has","set","responseHeaders","user","canSetHeaders","bearerToken","type","issueToken","token","authenticate","t","items","permissions","undefined","canUseMCP","filterMCPItems","access","providedPermissions","authorizedItems","item","checkItemAccess","push","tool","slug","collectionSlug","globalSlug","prompt","resource"],"mappings":"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"}
@@ -1,3 +1,3 @@
1
- import { type PayloadHandler } from 'payload';
1
+ import type { PayloadHandler } from 'payload';
2
2
  export declare const mcpEndpoint: PayloadHandler;
3
3
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/endpoint/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,SAAS,CAAA;AAMvD,eAAO,MAAM,WAAW,EAAE,cA2BzB,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/endpoint/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,SAAS,CAAA;AAe7D,eAAO,MAAM,WAAW,EAAE,cAkFzB,CAAA"}
@@ -1,36 +1,141 @@
1
- import { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/server';
1
+ import { createMcpHandler, isLegacyRequest, readRequestBody, WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/server';
2
2
  import { APIError } from 'payload';
3
3
  import { buildMcpServer } from '../mcp/buildMcpServer.js';
4
4
  import { getPluginConfig } from '../utils/getPluginConfig.js';
5
5
  import { getAuthorizedMCP } from './access.js';
6
+ import { getMCPResource, oauthChallenge } from './oauth.js';
6
7
  export const mcpEndpoint = async (req)=>{
7
8
  if (!req.url) {
8
9
  throw new APIError('Missing request URL', 400);
9
10
  }
10
11
  req.payloadAPI = 'MCP';
12
+ // Lets auth strategies check that an OAuth access token was issued for this MCP server
13
+ req.context.mcp = {
14
+ resource: getMCPResource({
15
+ req
16
+ })
17
+ };
11
18
  const pluginConfig = getPluginConfig({
12
19
  config: req.payload.config
13
20
  });
21
+ const overrideAccessParam = new URL(req.url).searchParams.get('overrideAccess');
22
+ if (overrideAccessParam !== null && process.env.NODE_ENV !== 'development') {
23
+ throw new APIError('MCP overrideAccess is only available in development.', 400);
24
+ }
25
+ let overrideAccess = false;
26
+ if (overrideAccessParam === 'true') {
27
+ overrideAccess = true;
28
+ } else if (overrideAccessParam !== null && overrideAccessParam !== 'false') {
29
+ throw new APIError('MCP overrideAccess must be "true" or "false".', 400);
30
+ }
14
31
  const authorizedMCP = await getAuthorizedMCP({
32
+ isHTTP: true,
33
+ overrideAccess,
15
34
  req
16
35
  });
17
- const server = buildMcpServer({
18
- authorizedMCP,
19
- pluginConfig,
20
- req
21
- });
22
- const transport = new WebStandardStreamableHTTPServerTransport({
23
- enableJsonResponse: true,
24
- sessionIdGenerator: undefined
36
+ // Clients like Codex send a GET first to find out where to sign in, so this comes before the
37
+ // GET check
38
+ if (pluginConfig.oauth && !req.user) {
39
+ return oauthChallenge({
40
+ req
41
+ });
42
+ }
43
+ // Streamable HTTP's optional server-to-client stream. We don't offer one, so answer 405 per
44
+ // spec, and clients skip it
45
+ if (req.method === 'GET') {
46
+ return new Response(null, {
47
+ headers: {
48
+ Allow: 'POST'
49
+ },
50
+ status: 405
51
+ });
52
+ }
53
+ const maxRequestBodySize = pluginConfig.mcp?.maxRequestBodySize;
54
+ // Payload augments the original web-standard Request in place.
55
+ const mcpRequest = req;
56
+ const parsedBody = await parseRequestBody({
57
+ maxRequestBodySize,
58
+ request: mcpRequest
25
59
  });
26
- await server.connect(transport);
27
- const mcpRequest = new Request(req.url, {
28
- body: req.body,
29
- duplex: 'half',
30
- headers: req.headers,
31
- method: req.method
60
+ // Keep the old JSON-only, stateless behavior because the SDK's 2025 fallback uses SSE.
61
+ if (await isLegacyRequest(mcpRequest, parsedBody, {
62
+ maxRequestBodySize
63
+ })) {
64
+ const server = buildMcpServer({
65
+ authorizedMCP,
66
+ pluginConfig,
67
+ req
68
+ });
69
+ const transport = new WebStandardStreamableHTTPServerTransport({
70
+ enableJsonResponse: true,
71
+ maxRequestBodySize,
72
+ sessionIdGenerator: undefined
73
+ });
74
+ transport.onerror = (err)=>{
75
+ req.payload.logger.error({
76
+ err,
77
+ msg: 'Error serving legacy MCP request'
78
+ });
79
+ };
80
+ try {
81
+ await server.connect(transport);
82
+ return await transport.handleRequest(mcpRequest, {
83
+ parsedBody
84
+ });
85
+ } finally{
86
+ await server.close().catch((err)=>{
87
+ req.payload.logger.error({
88
+ err,
89
+ msg: 'Error closing MCP server'
90
+ });
91
+ });
92
+ }
93
+ }
94
+ const handler = createMcpHandler(()=>buildMcpServer({
95
+ authorizedMCP,
96
+ pluginConfig,
97
+ req
98
+ }), {
99
+ legacy: 'reject',
100
+ maxRequestBodySize,
101
+ // SDK subscriptions always use SSE, so disable them to keep every response JSON-only.
102
+ maxSubscriptions: 0,
103
+ onerror: (err)=>{
104
+ req.payload.logger.error({
105
+ err,
106
+ msg: 'Error serving modern MCP request'
107
+ });
108
+ },
109
+ responseMode: 'json'
32
110
  });
33
- return await transport.handleRequest(mcpRequest);
111
+ try {
112
+ return await handler.fetch(mcpRequest, {
113
+ parsedBody
114
+ });
115
+ } finally{
116
+ await handler.close().catch((err)=>{
117
+ req.payload.logger.error({
118
+ err,
119
+ msg: 'Error closing modern MCP handler'
120
+ });
121
+ });
122
+ }
123
+ };
124
+ /**
125
+ * Parses a POST body once so the era check and the SDK handler can share it. The SDK
126
+ * skips its size limit for a pre-parsed body, so this reads with the same limit. It reads
127
+ * a clone and returns `undefined` for any body the SDK should reject (too large, unreadable,
128
+ * or not JSON), leaving the original request for the SDK to read and answer.
129
+ */ const parseRequestBody = async ({ maxRequestBodySize, request })=>{
130
+ if (request.method.toUpperCase() !== 'POST') {
131
+ return undefined;
132
+ }
133
+ try {
134
+ const body = await readRequestBody(request.clone(), maxRequestBodySize);
135
+ return body.tooLarge ? undefined : JSON.parse(body.text);
136
+ } catch {
137
+ return undefined;
138
+ }
34
139
  };
35
140
 
36
141
  //# sourceMappingURL=index.js.map