This guide walks through connecting Mindjoy to Canvas as an LTI 1.3 external tool. The setup involves five phases: copying Mindjoy's configuration values, creating an LTI Developer Key in Canvas, registering Canvas as a platform in Mindjoy, installing the tool in your Canvas account, and using Mindjoy in courses.

Before configuring Canvas, get Mindjoy's LTI values.

1. Log in to Mindjoy

2. In the left sidebar, click Organization (the building icon at the top)

3. Click Integrations in the settings menu

4. You will see the LTI 1.3 Settings page with a section called Mindjoy Tool Configuration

5. There are five values to copy. Keep this page open - you will need these in the next step:

Each value has a copy button next to it. Click to copy.

1. Log in to Canvas as an administrator

2. Click Admin in the left sidebar, then select your account

3. In the left navigation menu, click Developer Keys

4. Click the + Developer Key button in the top-right corner

5. A dropdown appears with three options. Select + LTI Key

6. The Key Settings dialog will open

7. Ensure Method is set to Manual Entry

8. Fill in the Required Values:

9. For JWK Method, select Public JWK URL from the dropdown (not "Public JWK")

10. In the Public JWK URL field that appears, enter: https://api.mindjoy.com/lti/jwks

11. Click LTI Advantage Services to expand the section

12. Enable the following services by checking their boxes:

14. Click Save

15. You will be returned to the Developer Keys list. Your new Mindjoy key will appear with a Client ID (a long number like 10000000000005). Note this down - you will need it for Phase 3 and Phase 4.

16. The key is created in the OFF state by default. Click the State toggle to switch it to ON

1. Go back to Mindjoy's LTI 1.3 Settings page (Organization > Integrations)

2. Scroll down past the "Mindjoy Tool Configuration" section

3. Click the + Register LTI 1.3 Platform button

4. A dialog titled Register LTI 1.3 Platform will appear

Fill in the fields using values from your Canvas instance. Replace https://yourschool.instructure.com with your actual Canvas URL throughout.

Note on Issuer: For Instructure-hosted Canvas instances (yourschool.instructure.com), the issuer is always https://canvas.instructure.com. For self-hosted Canvas, the issuer is your Canvas URL.

Note on Deployment ID: Canvas generates the Deployment ID when you install the app (Phase 4). You may need to come back and update your Mindjoy platform registration with the Deployment ID after completing Phase 4.

5. Click Register

Now connect the Developer Key to your account so teachers can use it.

1. Go to Admin > select your account > Settings

2. Click the Apps tab at the top

3. Click View App Configurations

4. Click + App

5. In the Add App dialog, change Configuration Type to By Client ID

6. Paste the Client ID from your Developer Key (e.g. 10000000000005)

7. Click Submit

8. Canvas will show a confirmation dialog with the tool name - click Install

The tool is now installed. The Deployment ID will be visible in the app configuration list - copy this and add it to your Mindjoy platform registration if you haven't already.

Once the tool is installed at the account level, Mindjoy becomes available in all courses. There are two ways teachers can access it.

After installation, Mindjoy appears as a link in the course sidebar navigation.

1. Navigate to a course in Canvas

2. Click Mindjoy in the left sidebar

3. Mindjoy will launch and you can browse tutors, pathways, and lessons

If Mindjoy doesn't appear in the sidebar by default, teachers can enable it:

1. Go to Settings in the course sidebar

2. Click the Navigation tab

3. Find Mindjoy in the hidden items list and drag it to the visible items

4. Click Save

To create a graded Mindjoy activity:

1. Go to Assignments in the course sidebar

2. Click + Assignment

3. For Submission Type, select External Tool

4. Click Find

5. Mindjoy will appear in the tool list - click on it to select it

6. The Mindjoy content picker will open - select the tutor, pathway, or lesson you want to assign

7. Configure grading settings as needed

8. Click Save

Students will see the assignment in their course and can launch Mindjoy directly from it.

The key must be toggled to ON in the Developer Keys list. Keys in the OFF state are not active.

Double-check the Client ID number. It must be copied exactly from the Developer Keys list.

Common causes:

Check that the Redirect URIs in the Developer Key includes https://api.mindjoy.com/lti/launch.

Replace https://yourschool.instructure.com with your actual Canvas URL.