# 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.