Conversation
There was a problem hiding this comment.
Pull request overview
This PR adds the mintlify-docs repository as a Git submodule and updates documentation to improve bot token guidance and fix broken internal links.
Changes:
- Added
mintlify-docsas a Git submodule pointing to the open-metadata/mintlify-docs repository - Enhanced bot token documentation with categorized bot descriptions and clearer usage instructions
- Fixed broken documentation links to point to the unified SDK authentication guide
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
.gitmodules |
Configures the mintlify-docs submodule with repository URL and path |
mintlify-docs |
Adds the submodule reference at a specific commit |
sdk/index.mdx |
Expands bot token documentation with categorized bot types and improved instructions |
collate-ai/mcp/cursor.mdx |
Updates authentication links to reference the SDK guide instead of deprecated paths |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ### Bot Token | ||
|
|
||
| 1. Go to the settings page from the navbar and then scroll down to the Integrations Section. Click on the Bots and you will see the list of bots, then click on the ingestion-bot. <img src="/public/images/apis/bots/bots.png" alt="bot-list" /> | ||
| Bot tokens are ideal for automated processes, integrations, and programmatic access. Choose the appropriate bot based on your use case: |
There was a problem hiding this comment.
Consider adding a period at the end of the sentence for consistency with other documentation sentences.
| Bot tokens are ideal for automated processes, integrations, and programmatic access. Choose the appropriate bot based on your use case: | |
| Bot tokens are ideal for automated processes, integrations, and programmatic access. Choose the appropriate bot based on your use case. |
|
|
||
| 3. Optionally, You can create your own bot for specific use case. | ||
| #### AI & Automation | ||
| - **McpApplicationBot**: For Model Context Protocol (MCP) integrations with AI assistants (Cursor, Claude, etc.) |
There was a problem hiding this comment.
The acronym 'MCP' is defined here but also appears in the category header 'AI & Automation' without context. Consider moving the MCP definition to the category header or the introductory text for better clarity when users first encounter the term.
| - **McpApplicationBot**: For Model Context Protocol (MCP) integrations with AI assistants (Cursor, Claude, etc.) | |
| Use the **Model Context Protocol (MCP)** standard for integrating AI assistants such as Cursor, Claude, and others. | |
| - **McpApplicationBot**: For MCP-based integrations with AI assistants |
| - Navigate to `<YOUR-Collate-SERVER>/marketplace/apps/` | ||
| - Install **McpApplication** if not already installed | ||
| 3. **[MCP Application and Personal Access Token](../authentication/bot-token-mcp.md)** - Follow this guide to generate your PAT | ||
| 3. **[MCP Application and Personal Access Token](/sdk#how-to-get-the-jwt-token)** - Follow this guide to generate your PAT |
There was a problem hiding this comment.
The link text mentions 'MCP Application and Personal Access Token' but the anchor #how-to-get-the-jwt-token may not specifically cover MCP Application setup. Verify that the linked section adequately covers both MCP Application installation and PAT generation, or consider updating the link text to accurately reflect the destination content.
| 3. **[MCP Application and Personal Access Token](/sdk#how-to-get-the-jwt-token)** - Follow this guide to generate your PAT | |
| 3. **[Personal Access Token (PAT)](/sdk#how-to-get-the-jwt-token)** - Follow this guide to generate your PAT |
…umentation updates
No description provided.