Skip to main content

Turn on the Blackboard MCP Server

The Blackboard® MCP Server is off by default. As a Blackboard LMS administrator, you decide when it is turned on and how your institution appears when people connect. This topic explains the decisions to make first, how to turn the server on, how your host names appear to people who connect, how to test it, and how to turn it off.

Before you begin

  • You need the System Administrator role in Blackboard LMS.

  • The built-in Guest user must be available. This is the Guest user account, not guest access to courses. See Why the Guest user? below.

  • Agree your institution's policy with your security, privacy and AI governance teams. The Security and AI Governance FAQ covers the questions they will ask.

  • Have a test or staging site available. Try the server there with safe, sample data before you turn it on in production.

Decisions to make first

Decision

What we recommend

Which AI assistants and plans are allowed

Institutionally managed business, enterprise or education seats that exclude your data from model training. Not personal accounts.

When a person must approve an action

Let read actions run. Require a person to approve writes and bulk actions. Set this centrally in each AI tool's admin console.

Who connects first

A pilot group. Make the Blackboard connector available to that group in your AI tool's admin console, and review their Blackboard LMS roles and permissions, because they limit every request.

Acceptable use

Update guidance for faculty, staff and students before you turn it on, including a ban on personal AI accounts for institutional data.

Turn on the Blackboard MCP Server

  1. Go to the Administrator Panel.

  2. In the Integrations section, where you find LTI and REST, select MCP.

  3. Select the Enable MCP server check box.

  4. Select Submit. You'll see the message MCP server enabled.

Turning the server on registers a REST API integration for the Blackboard MCP Server. You don't need to create or configure that integration yourself.

Why the Guest user?

Every REST API integration in Blackboard LMS is assigned a Blackboard LMS user. When you turn the server on, the MCP integration is assigned the built-in Guest user, the account with the least access, and it is set so it can't act as any other user.

That assignment is a placeholder. It doesn't let anyone use the server without signing in. Every request still requires the person to sign in with their own Blackboard LMS account, and runs only with their role and permissions.

The Guest user account only needs to be available. You don't need to allow guest access to courses or turn on any guest settings.

Once the server is on, the MCP page shows the Public MCP server endpoint, https://mcp.api.blackboard.com, and lists the host names people can choose from when they connect.

SCREENSHOT PLACEHOLDER MCP page after it is enabled, showing the Public MCP server endpoint and the list of host names that can be selected.

Choose how your institution appears

People connect using one address, https://mcp.api.blackboard.com. When they sign in, they choose your institution from a list. Which of your host names appear in that list, and what they're called, comes from your existing host name settings.

While the server is on, the MCP page includes a Configure host names link to those settings. For each host name you can set:

Setting

What it does

Friendly Name

The name people see when they choose your institution. If you leave it blank, the host name is shown.

Include in Public Host Lists

Whether people can choose this host name from the list when they connect.

Include at least one host name. If no host name is included in the public host lists, people have nothing to choose when they connect. Use a friendly name people will recognize, such as your institution's name.

When you save your host names, Blackboard LMS checks that each one reaches your site. A host name that fails the check is marked (Inaccessible) and isn't offered to people who connect.

Test before you widen access

Try this plan on your test or staging site with safe, sample data.

Check

How

It connects end to end

Connect an AI assistant and ask "List my courses." Real course names mean it works.

Your institution appears correctly

When you sign in, check that your institution appears in the list with the friendly name you chose.

Roles hold

Repeat as a test student, instructor and administrator. Ask the student account for an administrator action and expect a refusal.

Writes ask first

In a sandbox course, ask the assistant to create an announcement and a document. Confirm your AI tool asks for approval, and then check the result in the course.

It's auditable

Open a Blackboard Support case for your test requests and compare the audit records with what you did.

People find it useful

Pilot with a small group, collect their best prompts, and then widen access.

Help people connect

Share the server address and the tutorials for your approved AI tools:

https://mcp.api.blackboard.com

No client ID or secret is needed. The server registers each AI tool automatically when it connects.

On business, enterprise and education plans, your AI tool's administrator can usually add the Blackboard MCP Server once and choose who can use it. Each person then connects their own Blackboard LMS account. See Connect your AI tool to the Blackboard MCP Server.

Review activity

Every request through the server is logged with the time, the tool, the institution, a user reference, the parameters sent, the result and how long it took. Audit records are kept for 90 days. To get your institution's records, open a case with Blackboard Support. If you need them longer, request them within 90 days and keep them under your own records policy.

There is no self-service audit view.

Turn it off

Go to Integrations > MCP, clear the Enable MCP server check box, and select Submit. You'll see the message MCP server disabled. New connections stop right away. People who are already connected keep access until their token expires.

Troubleshooting

Symptom

Likely cause

What to do

"The Guest user could not be found, or is unavailable."

The Guest user is missing or unavailable.

Make the Guest user available, and then turn the server on again.

"MCP could not be configured right now."

The MCP Server couldn't be reached.

Try again later.

People can't find your institution when they sign in

No host name is included in the public host lists, or the host name failed its check.

Use Configure host names to include a host name, and fix any marked (Inaccessible).

A request returns nothing or an authorization message

The person's Blackboard LMS role doesn't allow that action or course.

This is expected. Check their role and course enrollments.

A write action ran without anyone approving it

The AI tool's approval policy isn't set.

Ask your AI tool administrator to require approval for writes and bulk actions.