@backstage/plugin-mcp-actions-backend 0.1.3-next.1 → 0.1.3
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.
- package/CHANGELOG.md +16 -0
- package/README.md +25 -0
- package/package.json +9 -9
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# @backstage/plugin-mcp-actions-backend
|
|
2
2
|
|
|
3
|
+
## 0.1.3
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 1d47bf3: Proxy `/.well-known/oauth-authorization-server` to `/.well-known/openid-configuration` on `auth-backend` when `auth.experimentalDynamicClientRegistration.enabled` is enabled.
|
|
8
|
+
- 7f2a4a0: Updating docs
|
|
9
|
+
- d08b0c9: The MCP backend will now convert known Backstage errors into textual responses with `isError: true`.
|
|
10
|
+
The error message can be useful for an LLM to understand and maybe give back to the user.
|
|
11
|
+
Previously all errors where thrown out to `@modelcontextprotocol/sdk` which causes a generic 500.
|
|
12
|
+
- Updated dependencies
|
|
13
|
+
- @backstage/backend-defaults@0.12.1
|
|
14
|
+
- @backstage/plugin-catalog-node@1.19.0
|
|
15
|
+
- @backstage/catalog-client@1.12.0
|
|
16
|
+
- @backstage/types@1.2.2
|
|
17
|
+
- @backstage/backend-plugin-api@1.4.3
|
|
18
|
+
|
|
3
19
|
## 0.1.3-next.1
|
|
4
20
|
|
|
5
21
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -103,6 +103,31 @@ node -p 'require("crypto").randomBytes(24).toString("base64")'
|
|
|
103
103
|
|
|
104
104
|
Set the `MCP_TOKEN` environment variable with this token, and configure your MCP client to use it in the [Authorization header](#configuring-mcp-clients)
|
|
105
105
|
|
|
106
|
+
#### Experimental: Dynamic Client Registration
|
|
107
|
+
|
|
108
|
+
> [!CAUTION]
|
|
109
|
+
> This is highly experimental, proceed with caution.
|
|
110
|
+
|
|
111
|
+
You can configure the `auth-backend` and install the `auth` frontend plugin in order to enable [Dynamic Client Registration](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization#dynamic-client-registration) with MCP Clients.
|
|
112
|
+
|
|
113
|
+
This means that there is no token required in your MCP settings, and a token will be given to a client that requests a token on your behalf. When adding the MCP server to an MCP client like Cursor or Claude, a popup that requires your approval will be opened in your Backstage instance, which is powered by the `auth` plugin.
|
|
114
|
+
|
|
115
|
+
You will need to add the `@backstage/plugin-auth` package to your `app` `package.json`, and enable the following config in `app-config.yaml`:
|
|
116
|
+
|
|
117
|
+
```yaml
|
|
118
|
+
auth:
|
|
119
|
+
experimentalDynamicClientRegistration:
|
|
120
|
+
# enable the feature
|
|
121
|
+
enabled: true
|
|
122
|
+
|
|
123
|
+
# this is optional and will default to *, but you can limit the callback URLs which are valid for added security
|
|
124
|
+
allowedRedirectUriPatterns:
|
|
125
|
+
- cursor://*
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
> [!NOTE]
|
|
129
|
+
> The `@backstage/plugin-auth` package is currently only available in the new frontend system.
|
|
130
|
+
|
|
106
131
|
## Configuring MCP Clients
|
|
107
132
|
|
|
108
133
|
The MCP server supports both Server-Sent Events (SSE) and Streamable HTTP protocols.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@backstage/plugin-mcp-actions-backend",
|
|
3
|
-
"version": "0.1.3
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"backstage": {
|
|
5
5
|
"role": "backend-plugin",
|
|
6
6
|
"pluginId": "mcp-actions",
|
|
@@ -37,20 +37,20 @@
|
|
|
37
37
|
"test": "backstage-cli package test"
|
|
38
38
|
},
|
|
39
39
|
"dependencies": {
|
|
40
|
-
"@backstage/backend-defaults": "0.12.1
|
|
41
|
-
"@backstage/backend-plugin-api": "1.4.3
|
|
42
|
-
"@backstage/catalog-client": "1.12.0
|
|
43
|
-
"@backstage/errors": "1.2.7",
|
|
44
|
-
"@backstage/plugin-catalog-node": "1.19.0
|
|
45
|
-
"@backstage/types": "1.2.
|
|
40
|
+
"@backstage/backend-defaults": "^0.12.1",
|
|
41
|
+
"@backstage/backend-plugin-api": "^1.4.3",
|
|
42
|
+
"@backstage/catalog-client": "^1.12.0",
|
|
43
|
+
"@backstage/errors": "^1.2.7",
|
|
44
|
+
"@backstage/plugin-catalog-node": "^1.19.0",
|
|
45
|
+
"@backstage/types": "^1.2.2",
|
|
46
46
|
"@modelcontextprotocol/sdk": "^1.12.3",
|
|
47
47
|
"express": "^4.17.1",
|
|
48
48
|
"express-promise-router": "^4.1.0",
|
|
49
49
|
"zod": "^3.22.4"
|
|
50
50
|
},
|
|
51
51
|
"devDependencies": {
|
|
52
|
-
"@backstage/backend-test-utils": "1.9.0
|
|
53
|
-
"@backstage/cli": "0.34.2
|
|
52
|
+
"@backstage/backend-test-utils": "^1.9.0",
|
|
53
|
+
"@backstage/cli": "^0.34.2",
|
|
54
54
|
"@types/express": "^4.17.6"
|
|
55
55
|
},
|
|
56
56
|
"typesVersions": {
|