# Canvas LTI Installation Guide

## Tychos Works with Instructure Canvas <a href="#tychos-works-with-instructure-canvas" id="tychos-works-with-instructure-canvas"></a>

### What's good about Canvas LTI Apps? <a href="#whats-good-about-canvas-lti-apps" id="whats-good-about-canvas-lti-apps"></a>

When using LTI, Canvas will tell Tychos who is logged in. This allows your students to save copies of your master scenario under their name. If the same student clicks the module again in Canvas, they will get their last saved version of the Scenario instead of the master scenario.

### Adding Tychos as a Canvas LTI App <a href="#adding-tychos-as-a-canvas-lti-app" id="adding-tychos-as-a-canvas-lti-app"></a>

This app can be installed as an LTI plugin with Instructure Canvas. Here is how to do it:

* In Canvas, go to Settings > Apps > View App Configurations
* Click the blue "+" button. You should see the Add App form.
* For the **Configuration Type** choose **By URL**.
* For the **Configuration URL** use this URL: **<https://tychos.org/lti\\_config.xml>**

The **Add App** form should look like this:

![](/files/-Ln5AWy_9F-vd7NY40uA)

### Adding a Tychos Scenario to a Canvas Module (or as an Assignment) <a href="#adding-a-tychos-scenario-as-a-canvas-module" id="adding-a-tychos-scenario-as-a-canvas-module"></a>

* Go to the Scenario you want to add. Take a note of the code at the end of the your URL. E.g. tychos.org/scenarios/xxxxxx means your scenario id id **xxxxxx**.
* In Canvas, go to Modules > "+" Button. You should see the Add Item to... popup. Choose:
* Add: **External Tool**
* Click on **Tychos**. Notice the URL gets filled in with a URL ending with `...tychos.org/lti`
* **URL**: Add your scenario code from above to the end of the URL, e.g. `...tychos.org/lti/xxxxxx`
* **Page Name**: copy the name of your Scenario
* Click Add Item


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tychos.org/docs/for-teachers/canvas-lti-installation-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.