61 lines
2.7 KiB
Markdown
61 lines
2.7 KiB
Markdown
# SHD MCP in ChatGPT
|
||
|
||
This file describes the user-side connection. The repository cannot create an
|
||
app inside another person’s ChatGPT account and never stores OAuth tokens.
|
||
|
||
## Custom app
|
||
|
||
1. Open ChatGPT settings and enable Developer mode for Apps/Connectors.
|
||
2. Create a custom app with this MCP endpoint:
|
||
|
||
`https://shd.xyz.su/mcp`
|
||
|
||
3. Complete the SHD OAuth sign-in and consent screen.
|
||
4. Start a new chat or refresh the app connection.
|
||
5. Test with: `Покажи активные проекты с датой завершения и статусом.`
|
||
|
||
The server publishes OAuth 2.1 discovery for the root resource and supports
|
||
ChatGPT Client ID Metadata Documents (CIMD), PKCE S256 and the
|
||
`private_key_jwt` token-endpoint authentication method. Keep the app URL as
|
||
`https://shd.xyz.su/mcp`; the retired `/mcp/system-data` resource is not a
|
||
valid replacement for the root MCP resource.
|
||
|
||
The expected flow is:
|
||
|
||
1. ChatGPT calls `shd_list_projects` with `archived: false`.
|
||
2. ChatGPT may call a module render tool after the corresponding list tool:
|
||
`shd_render_projects_widget`, `shd_render_documents_widget`,
|
||
`shd_render_tasks_widget`, `shd_render_finance_widget` or
|
||
`shd_render_crm_widget`.
|
||
3. The selected widget renders a read-only register and can call the matching
|
||
detail tool for one selected row.
|
||
|
||
The widget resources are versioned at `ui://shd/active-projects/v1.html`,
|
||
`ui://shd/documents/v1.html`, `ui://shd/tasks/v1.html`,
|
||
`ui://shd/finance/v1.html` and `ui://shd/crm/v1.html`.
|
||
|
||
The MCP tools remain usable without the widget. A failed OAuth connection is
|
||
an account/endpoint configuration problem, not a missing token in this repo.
|
||
|
||
## Public directory
|
||
|
||
Directory submission is a separate optional release step. It is needed for
|
||
public discovery and reviewed installation, not for internal use or a custom
|
||
app added manually in ChatGPT. Before submission, the owner must provide the
|
||
production HTTPS endpoint, OAuth metadata, privacy/support URLs, accurate app
|
||
metadata, test prompts and any review credentials requested by OpenAI.
|
||
|
||
Use the official [submission guide](https://developers.openai.com/plugins/deploy/submission)
|
||
and [plugin guidelines](https://developers.openai.com/plugins/app-guidelines).
|
||
|
||
## License choice
|
||
|
||
This repository currently uses the proprietary SHD MCP Plugin License. Public
|
||
visibility means the source can be viewed; it does not grant permission to
|
||
redistribute, resell, modify or use it outside an authorized SHD account.
|
||
|
||
MIT would grant anyone permission to use, copy, modify, publish, sublicense and
|
||
sell the plugin, including forks, while retaining only the copyright notice and
|
||
license text. Switching to MIT is a product/legal decision and is not done
|
||
implicitly by publishing the repository.
|