Skip to main content
This guide is intended for LMS administrators. If you encounter any issues during the integration process, please contact your Nectir AI account manager or email support@nectir.io.

​
Guided Canvas LTI Setup

The guided setup in Nectir AI walks you through the entire integration process. Follow these steps to get started:
  1. Go to your Nectir AI account
  2. Navigate to Workspace settings > LMS integration
  3. Select Add integration
  4. Select Connect for Canvas
  5. Select LTI integration
  6. The guided setup opens
Follow the instructions in the guided setup to complete the integration.

​
Technical Reference

This section documents the technical steps that the guided setup handles for you. It’s useful for understanding how the integration works or for troubleshooting issues.

​
Install the App in Canvas

  1. In Canvas, navigate to the Admin panel
  2. Go to Apps
  3. Select the Manage tab
  4. Select Install a New App
  5. In the Install Method dropdown, select JSON
Canvas Install App dialog showing the Install Method dropdown with JSON selected
  1. Copy the JSON configuration from the guided setup. If you use the JSON below, make sure to replace YOUR_WORKSPACE_ID with your actual Workspace ID from Nectir AI.
{
  "title": "Nectir AI",
  "description": "Nectir provides educational institutions with managed AI infrastructure that seamlessly integrates with their Learning Management Systems (LMS). Configure custom AI Assistants grounded in specific courses, policies, and institutional knowledge, and get real-time support while ensuring data privacy and FERPA compliance. Nectir AI provides students with 24/7 guidance, instant feedback, and concept clarification, while reducing instructor workloads and surfacing learning gaps.",
  "target_link_uri": "https://ai.nectir.io/api/lti13/validate",
  "oidc_initiation_url": "https://ai.nectir.io/api/lti13/login",
  "oidc_initiation_urls": {},
  "public_jwk_url": "https://ai.nectir.io/api/lti13/keys",
  "public_jwk": {},
  "custom_fields": {
    "workspaceId": "YOUR_WORKSPACE_ID",
    "masqueradingUserId": "$Canvas.masqueradingUser.id"
  },
  "scopes": [
    "https://purl.imsglobal.org/spec/lti-nrps/scope/contextmembership.readonly",
    "https://purl.imsglobal.org/spec/lti-ags/scope/lineitem",
    "https://purl.imsglobal.org/spec/lti-ags/scope/lineitem.readonly",
    "https://purl.imsglobal.org/spec/lti-ags/scope/result.readonly",
    "https://purl.imsglobal.org/spec/lti-ags/scope/score",
    "https://purl.imsglobal.org/spec/lti-reg/scope/registration",
    "https://purl.imsglobal.org/spec/lti-reg/scope/registration.readonly",
    "https://canvas.instructure.com/lti/public_jwk/scope/update",
    "https://canvas.instructure.com/lti/account_lookup/scope/show"
  ],
  "extensions": [
    {
      "domain": "ai.nectir.io",
      "tool_id": "",
      "privacy_level": "public",
      "platform": "canvas.instructure.com",
      "settings": {
        "default": "disabled",
        "icon_url": "https://ai.nectir.io/icon.png",
        "platform": "canvas.instructure.com",
        "custom_fields": {
          "workspaceId": "YOUR_WORKSPACE_ID",
          "masqueradingUserId": "$Canvas.masqueradingUser.id"
        },
        "message_settings": [],
        "placements": [
          {
            "text": "",
            "placement": "account_navigation",
            "display_type": "full_width_in_context",
            "message_type": "LtiResourceLinkRequest",
            "target_link_uri": "https://ai.nectir.io/api/lti13/validate"
          },
          {
            "text": "",
            "default": "disabled",
            "placement": "course_navigation",
            "display_type": "full_width_in_context",
            "message_type": "LtiResourceLinkRequest",
            "target_link_uri": "https://ai.nectir.io/api/lti13/validate"
          }
        ]
      }
    }
  ]
}
  1. Paste the JSON into the configuration field
  2. Select Next
  3. Confirm your Workspace ID appears in the Custom Fields section
  4. Select Next through the remaining sections (these are automatically configured from the JSON).
If you’re installing multiple Nectir AI apps for different schools, you can add a Nickname in the Nickname section to distinguish between them (for example, Nectir AI - Your Institution)
  1. Select Install App
Canvas app integration page showing Nectir AI configuration options after installation

​
Enable the App in Canvas

  1. After installation, you’ll see the Nectir AI app page in Canvas
  2. Select Availability and Exceptions
  3. Click the pencil icon to edit
  4. Change from Not Available to Available
  5. Save
  6. Copy the Client ID from the app details

​
Complete the Connection in Nectir AI

  1. Return to the guided setup in Nectir AI
  2. Paste the Client ID
  3. Enter your Canvas URL (for example, https://yourinstitution.instructure.com)
  4. Select Save and continue
  5. Select Finish setup

​
Test the Integration

Test the integration by accessing Nectir AI from a Canvas course.
If you receive an error, ensure you’ve completed all steps including enabling the app in the “Enable the App in Canvas” section above.

​
District Sub-Account Setup

This section is for institutions that manage Canvas at the district level with separate sub-accounts for each college.
If your Canvas instance serves colleges with separate sub-accounts, you can configure dedicated Nectir Workspaces for each one. This ensures each college accesses only their designated Workspace.

​
Setting Up Additional Nectir Apps

  1. Repeat the guided setup for each college, creating a separate Nectir AI app with that college’s Workspace ID
  2. Each app connects to a different Nectir Workspace

​
Restricting App Access by Sub-Account

For each Nectir AI app you created:
  1. In Canvas, go to Admin > Apps > Manage
  2. Select the Nectir AI app for that college
  3. Go to the Availability and Exceptions section
  4. Select Add Exception
  5. Choose the sub-account for the college that should access this app
  6. In the dropdown, select Available
  7. Save
You can also add exceptions for individual courses, not just sub-accounts.
Hide the app at the district level to prevent it from appearing outside the designated sub-account:
  1. In the Availability and Exceptions panel, select the pencil icon for the root account
  2. In the dropdown, select Not Available
Canvas availability modal showing the dropdown with Not Available selected
  1. Select Save
This setup allows each college to have its own isolated Nectir LTI integration under a single Canvas instance.

​
Instructor Setup Guide

After completing the LTI integration setup in the preceding section, instructors can follow the Canvas Workspace Setup guide to:
  • Link their Canvas courses to Nectir Groups
  • Configure role mapping
  • Set up roster sync
  • Manage courses across terms

​
Troubleshooting

If you’re experiencing issues with your Canvas integration: For Canvas-specific problems: go to Canvas Integration Issues for help with:
  • Assistant doesn’t appear in Canvas course
  • Login prompts when accessing through Canvas
  • Connection confirmation issues
  • Course linking problems
For general browser problems: go to Browser & Display Issues for help with:
  • Pages not loading correctly
  • Broken layouts or missing buttons
  • Cache and cookie issues
  • Browser compatibility problems
For other issues: contact support at support@nectir.io