🧪 Beta feature: This feature is currently in beta. If you'd like access, please contact your account manager or email us at [email protected].

Classcard exposes an MCP (Model Context Protocol) server that lets any compatible AI client read your institution data (students, staff, invoices, calendar, and 20+ other tools) directly inside your AI assistant. The client only sees what your Classcard role allows.

MCP URL: https://api.classcardapp.com/mcp/v1

Before You Start

You need an admin-level Classcard account (Owner, Admin, Sales, or Front Office role). Student and parent accounts cannot use MCP.
Have your Classcard email and password ready. You'll sign in through Classcard's own OAuth page during setup.
The MCP URL above is the same for every client on this page.

i. Claude (claude.ai & Claude Desktop)

Open claude.ai → click your profile picture (top-right) → Settings.
Go to the Connectors tab → click Add custom connector.
Paste https://api.classcardapp.com/mcp/v1 in the URL field, give it a name (e.g. Classcard) → click Add.
On the connector card, click Connect → a new tab opens with Classcard's OAuth page.
Sign in with your Classcard email and password → pick your institution → click Allow.
The tab closes and the connector card should show something like "26 tools available".
Open any conversation. The Classcard tools are now ready to use.

💡 Claude Desktop users: connectors are managed under Settings → Connectors, the same as on claude.ai.

ii. ChatGPT

Requires a Business, Team, Enterprise, or Pro plan. Free and Plus accounts cannot add custom MCP connectors. ChatGPT renamed "Connectors" to "Plugins" - adding a custom MCP is still gated on Developer mode.

Open chatgpt.com → click your profile (bottom-left) → Settings.
Go to the Plugins tab → click the Developer mode link (opens Security → Developer mode) → toggle it on.
Close Settings → open Plugins from the left sidebar (or go to chatgpt.com/plugins).
Click Create app (top of the page).
Paste https://api.classcardapp.com/mcp/v1 in the MCP Server URL field, name it Classcard.
Authentication → pick OAuth → Create.
On the plugin card, click Connect → a new tab opens with Classcard's OAuth page.
Sign in → pick the institution → Allow.
In any chat, click + (attach) → your Classcard plugin is under Developer plugins.

iii. Cursor

Open Cursor → press ⌘ , (macOS) or Ctrl+, (Windows/Linux) → Tools & MCP.
Click + Add new MCP server.
Fill in the fields:
- Name: Classcard
- Type: HTTP (or SSE if HTTP isn't offered)
- URL: https://api.classcardapp.com/mcp/v1
- Headers: leave empty
Click Install → Cursor opens the Classcard OAuth page → sign in → pick your institution → Allow.
Restart Cursor if it doesn't pick up the connection automatically. A green dot on the Classcard row confirms it's live. Hover to see the tool list.

iv. Cline, Continue, Zed & Other MCP Clients

Any MCP client that uses the stdio transport connects through mcp-remote - a small npm package that bridges the connection. Add the following entry to your client's MCP config file:

{
  "mcpServers": {
    "classcard": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.classcardapp.com/mcp/v1"]
    }
  }
}

Restart the client → mcp-remote launches and opens the OAuth flow in your browser.
Sign in → pick institution → Allow. The token is cached under ~/.mcp-auth/ so you won't be asked again.
Restart the client one more time, the Classcard tools should appear.

Config file locations:

Claude Desktop (macOS/Linux): ~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
Cline (VS Code): Settings → search "MCP" → Cline MCP Servers → Edit
Continue: ~/.continue/config.json under experimental.modelContextProtocolServers
Zed: ~/.config/zed/settings.json under context_servers