IsharaBeta
Agent guides (16)

Connect VS Code with GitHub Copilot to Ishara

Connect GitHub Copilot in VS Code to Ishara’s MCP server with a .mcp.json file, so agent mode can apply your reviewers’ edits.

Server
https://useishara.com/mcp
Where it goes
.mcp.json in your workspace, or ~/.copilot/mcp-config.json
Transport
Streamable HTTP, built in
Authentication
A bearer token in the Authorization header
Time
About 3 minutes

Steps

  1. In Ishara, open Agents, name a token under New token (for example “VS Code (Copilot) on my laptop”) and click Create token. Copy it now: it won’t be shown again.

  2. Add Ishara to VS Code with GitHub Copilot, with your token in place of ishara_…:

    .mcp.json
    {
      "mcpServers": {
        "ishara": {
          "type": "http",
          "url": "https://useishara.com/mcp",
          "headers": { "Authorization": "Bearer ${ISHARA_TOKEN}" }
        }
      }
    }

    At the root of your workspace, or in ~/.copilot/mcp-config.json for every workspace. VS Code reads ${ISHARA_TOKEN} from your environment.

    .vscode/mcp.json
    {
      "inputs": [
        { "type": "promptString", "id": "ishara-token", "description": "Ishara token", "password": true }
      ],
      "servers": {
        "ishara": {
          "type": "http",
          "url": "https://useishara.com/mcp",
          "headers": { "Authorization": "Bearer ${input:ishara-token}" }
        }
      }
    }

    The older format, which asks for the token once and stores it securely. VS Code says this “Local harness” will be removed in February 2027.

  3. Run MCP: List Servers from the Command Palette, and start ishara if it isn’t running. VS Code asks you to trust it the first time.

  4. In Copilot Chat, switch to agent mode and open the tools picker: Ishara’s tools are listed. Ask your agent: “Apply the open Ishara notes.” It lists them, applies each edit in your code, and marks each note done with a reply the reviewer sees on the site. Expand the first tool call to check it used Ishara.

Good to know

  • The type is http in both formats, not streamableHttp.
  • Agent mode needs VS Code 1.99 or later; remote MCP servers arrived in 1.102.

What your agent can do

ToolWhat it does
list_sitesThe sites (embeds) in this account, with how many notes are open on each and what agents may see there.
list_notesNotes reviewers left on the live sites, newest first. Default: open notes (new and in progress) on every site. Each has an id for get_note and update_note, and a short ref like "N-12".
get_noteOne note in full: the page, the section heading, the CSS selector, the text before and after, the reviewer's words and its history.
get_note_photoThe photo a reviewer attached (the replacement image, or one that shows the problem), as an image. With which: "screenshot", the screenshot of the page as the reviewer saw it, any element they picked ringed in gold (get_note says whether a note has one).
update_noteSet a note's status and/or reply. The reviewer sees both in the widget on their site. Use "doing" while working, "done" once the change is committed or deployed, "wontdo" with a reason when it will not be applied. Write the reply in the reviewer's language.
export_notesEvery open note, grouped by page, as one Markdown document (a checklist to work through).

Reviewers are people outside your team, so their words reach the agent marked as untrusted data, never as instructions. On sites where anyone can leave a note, set the site to Accepted notes only: agents see a note only after a person moves it to In progress.