Using AI & the Academy Shade MCP
Easily understand how to use Shade by connecting our docs MCP directly into your LLMs
Connect the Academy Shade MCP to any MCP-compatible client with this server URL:
https://academy.shade.inc/~gitbook/mcp
If your client supports remote MCP servers, setup usually takes less than a minute.
Quick dropdown
You can add the MCP or copy context directly from the docs.
Add it to your client
Different clients use different names. You may see MCP server, connector, tool, or integration. The flow is the same.
Open Claude's Settings.
Find the MCP, Tools, or Integrations area.
Add a new server.
Name it Academy Shade.
Paste this URL:
https://academy.shade.inc/~gitbook/mcpSave the server.
Refresh Claude if needed.
Test it with:
How do I set up a workspace in Shade?What is the difference between guests and members?
Open Cursor Settings.
Go to the MCP or Tools section.
Add a new MCP server.
Name it Academy Shade.
Paste this URL:
https://academy.shade.inc/~gitbook/mcpSave the server.
Refresh Cursor if needed.
Use it from chat or agent mode with a prompt like:
How does ShadeFS caching work?How do I invite a guest into Shade?
Open your Tools, Connectors, or MCP settings.
Add a custom server if that option is available.
Name it Academy Shade.
Paste this URL:
https://academy.shade.inc/~gitbook/mcpSave the server.
Refresh the session if needed.
Test it with:
How do permissions work in Shade?How do I mount a drive in ShadeFS?
If your ChatGPT or Codex environment does not expose custom MCP servers yet, use the Academy Shade MCP through Claude, Cursor, or another MCP-compatible client instead.
Open the MCP-compatible extension you use in VS Code.
Go to that extension's MCP or Server settings.
Add a new remote server.
Name it Academy Shade.
Paste this URL:
https://academy.shade.inc/~gitbook/mcpIf prompted for transport, use the standard remote HTTP option the extension recommends.
Save the configuration.
Reload VS Code or restart the extension if needed.
Test it with:
How do I create a BYOS drive in Shade?How do comments work on assets?
Open your client's MCP, Tools, or Connectors settings.
Add a new remote server.
Name it Academy Shade.
Paste this URL:
https://academy.shade.inc/~gitbook/mcpSave the configuration.
Refresh the client if needed.
Test it with:
How do I search with AI in Shade?What is the difference between guests and workspace members?
What to expect after connecting
Once connected, your assistant can help with:
Shade onboarding
Workspace and permission questions
ShadeFS setup and troubleshooting
It is best for product guidance, workflows, and docs lookups.
Troubleshooting
If the server does not appear:
Confirm the URL is exactly
https://academy.shade.inc/~gitbook/mcpRefresh or fully restart the client
Make sure your client supports remote MCP servers
If your client only supports local MCP servers, use an MCP-compatible client that supports remote servers instead.
Last updated
Was this helpful?