@sentry/junior-notion 0.268.0 → 0.269.0
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/README.md +3 -38
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,50 +1,15 @@
|
|
|
1
1
|
# @sentry/junior-notion
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
Install it alongside `@sentry/junior`:
|
|
3
|
+
Notion page and data source search, fetch, and limited writes for Junior through Notion's hosted MCP server.
|
|
6
4
|
|
|
7
5
|
```bash
|
|
8
6
|
pnpm add @sentry/junior @sentry/junior-notion
|
|
9
7
|
```
|
|
10
8
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
```ts title="plugins.ts"
|
|
9
|
+
```ts
|
|
14
10
|
import { defineJuniorPlugins } from "@sentry/junior";
|
|
15
11
|
|
|
16
12
|
export const plugins = defineJuniorPlugins(["@sentry/junior-notion"]);
|
|
17
13
|
```
|
|
18
14
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
Optionally, a Junior admin can connect a Notion service account from the dashboard Admin page, or with `junior service-account connect notion`. The manifest lets that account call only `notion-search` and `notion-fetch` (`accounts.service-account.tools`). Users who have not connected Notion then use that account for those tools. Write tools still ask the user to connect their own account.
|
|
22
|
-
|
|
23
|
-
The package exposes a deliberately limited Notion MCP surface:
|
|
24
|
-
|
|
25
|
-
- `notion-search`
|
|
26
|
-
- `notion-fetch`
|
|
27
|
-
- `notion-create-pages`
|
|
28
|
-
- `notion-update-page`
|
|
29
|
-
- `notion-move-pages`
|
|
30
|
-
|
|
31
|
-
It does not expose broader administrative or destructive Notion tools such as database deletion or unrestricted schema changes.
|
|
32
|
-
|
|
33
|
-
## Search limitations
|
|
34
|
-
|
|
35
|
-
This package uses Notion MCP search and fetch rather than the older REST helper flow.
|
|
36
|
-
|
|
37
|
-
- Search is still title-biased, so prompts work best when users search for the actual page or data source title.
|
|
38
|
-
- Results can differ from the Notion UI even when the user can see a page in the app.
|
|
39
|
-
- Search across connected sources like Slack, Google Drive, and Jira requires a Notion AI plan. Without Notion AI, search is limited to the user's Notion workspace.
|
|
40
|
-
- Missing results are usually a permissions problem on the user's Notion account or a weak query phrase.
|
|
41
|
-
|
|
42
|
-
## Auth model
|
|
43
|
-
|
|
44
|
-
- Notion MCP requires user-based OAuth and does not support bearer token authentication.
|
|
45
|
-
- Without a service account, this package is not suitable for fully headless or unattended automation. With one, automations can read but not write.
|
|
46
|
-
- Anyone who can talk to Junior can read what the service account can read.
|
|
47
|
-
- Users can disconnect from Junior App Home with `Unlink`, or by asking Junior to disconnect Notion.
|
|
48
|
-
- Existing OAuth connections may need reauthorization if Notion requires additional scopes for write tools.
|
|
49
|
-
|
|
50
|
-
Full setup guide: https://junior.sentry.dev/extend/notion-plugin/
|
|
15
|
+
Setup and configuration: https://junior.sentry.dev/extend/notion-plugin/
|