Connect an assistant to Knyte

What the connector does

In Knyte a project is called a knyte (plural knyten). An assistant connected to Knyte acts for the person who connected it, with that person’s access: it sees the knyten they are a member of and nothing else. When two members each connect their own assistant, both assistants read the same knyte.

Reads

The project’s purpose and current focus, the materials and their text (page by page for a PDF, section by section for a linked Google Doc or Word document), passages members marked, notes, tasks, milestones, decisions, findings, requests and recent activity.

Adds

Notes, tasks, proposed findings and proposed reference details, and a new knyte for the person it acts for. It can also draft a request to another member, which reaches no one until the person sends it in Knyte. Everything it adds is marked as an assistant’s contribution and attributed to the person.

Cannot

Change or delete the project’s purpose, decisions, milestones or anything people wrote, confirm findings, send requests or comments, or download original files.

Before you connect

• A Knyte account. Sign up at knyte.app with email, Google or Microsoft. The free plan is enough: it includes one knyte of your own and two that others started.
• An assistant that supports remote MCP servers with OAuth sign-in, such as Claude on the web or in the desktop app, Claude Code or ChatGPT.
• On a Claude Team or Enterprise plan, an owner of the organisation has to add the connector before members can connect it.

Connect

Knyte’s server address is https://knyte.app/mcp. It is also under Assistants in Knyte. You sign in once for each assistant.

Open Knyte in the Claude directory

Claude

1. Open Knyte in the Claude directory, linked above, and choose Connect. You don’t need to enter the server address.
2. Sign in to Knyte when Claude asks, and choose Allow access.
3. In a chat, ask Claude to list your knyten. No answer? Turn on Knyte under + in the chat.

Claude Code

1. In a terminal, run claude mcp add --transport http knyte https://knyte.app/mcp.
2. In Claude Code, type /mcp, choose knyte, then Authenticate.
3. Sign in to Knyte in the browser window that opens, and choose Allow access.

Knyte will say that Claude Code is not a recognised assistant, because it returns to your own computer rather than to claude.ai. Allow access only if you started the connection yourself.

ChatGPT

1. In ChatGPT, open Plugins in the sidebar, choose Add, then Add custom MCP server.
2. Name it Knyte and paste https://knyte.app/mcp under Connection.
3. Tick “I understand and want to continue”, choose Create as a plugin, then sign in to Knyte and choose Allow access.
4. Ask ChatGPT to list your knyten. No answer? Turn on the Knyte plugin for the chat.

Another MCP client

1. Point the client at https://knyte.app/mcp. An unauthorised request gets 401 and a WWW-Authenticate header naming the protected resource metadata at /.well-known/oauth-protected-resource/mcp, which names Knyte’s authorization server.
2. The client registers itself with dynamic client registration and signs in with the authorization code flow and PKCE. Access tokens last an hour and are renewed with a refresh token.
3. Sign in to Knyte and choose Allow access.

Example prompts

Ask in your own words and in any language; the assistant chooses the tools. These are the things groups ask most.

What’s the state of our thesis knyte? What did we decide about the method, and is anything waiting for me?

The assistant finds the knyte, reads its briefing (purpose, current focus, what the group confirmed and what members have asked of you) and the decisions with their reasoning, then answers from them.

Tools used: list_projects, get_project_context, list_decisions

Where do our sources discuss interrater reliability? Quote the passages with page numbers.

The assistant searches the text of every material in the knyte, reads around the passages it finds, and quotes them with the printed page of a PDF, or the heading and paragraph of a linked document.

Tools used: search_material_text, get_material_text

Give me our reference list in the style the group chose, and tell me which sources are missing details.

The assistant gets the references formatted in the group’s style, with how to cite each one in the text, and lists what the style asks for that a source’s details lack.

Tools used: get_reference_list

Read the article on sampling in our materials and save a short summary as a note for the group.

The assistant finds the article, reads its text and adds a note. The group sees the note in the knyte, marked as an assistant’s contribution with your name on it.

Tools used: list_materials, get_material_text, create_note

Ask Sara to review the sampling note by Friday.

The assistant drafts a request from you to Sara with a due date. It waits in Knyte, seen only by you, until you send or drop it.

Tools used: get_project_context, list_notes, propose_request

Tools

Every tool has a title and is annotated: tools that read are marked read-only, and tools that write are not. Two of the tools that write are also marked destructive, because they replace something that is waiting: propose_source_metadata replaces a proposal no one has decided on yet, and propose_request replaces your own unsent draft of the same request. No tool changes or deletes what people wrote. Every tool except list_projects, get_current_user, create_project and list_requests takes the knyte’s project_id.

Tools that read

list_projectsList projects

The knyten you are a member of, with the IDs the other tools use.

get_current_userGet current user

The name and email of the Knyte account the connection acts for.

get_project_contextGet project context

A briefing on one knyte: what the group confirmed, what assistants contributed, findings no one has confirmed, requests waiting for you, members, which materials can be read, and recent activity.

list_materialsList materials

Up to 50 materials at a time, with summaries, tags and whether their text can be read; a linked Google Doc or Word document comes with its outline.

get_materialGet material

One material’s full record, including pasted text and file details.

get_material_textRead material text

A material’s text, page by page for a PDF or section by section for a linked document, with paragraph numbers to cite.

search_material_textSearch material text

Find passages in the materials with web-search syntax, each with the page or paragraph to cite.

list_annotationsList marked passages

Passages members highlighted in PDFs, with their comments and the page to cite.

list_sourcesList sources

Each source’s citation details (authors, year, DOI, CSL-JSON) and how far to trust them.

get_reference_listGet reference list

The references formatted in the group’s style (APA 7, Harvard, Oxford, IEEE, Vancouver or Chicago), with in-text citations.

list_findingsList findings

Claims with their evidence and whether a person verified them, optionally filtered by state.

list_decisionsList questions and decisions

The group’s open questions and the decisions it recorded, with reasoning, date and linked materials and tasks. An answered question is its decision.

list_notesList notes

Up to 50 notes, briefs, checklists and open questions at a time.

get_noteGet note

One note in full.

list_tasksList tasks

Tasks with status, assignee, due date and milestone.

list_milestonesList milestones

Milestones with target dates and whether each has been reached.

list_requestsList requests

What members have asked of you and is not done, what you asked of others, and drafts waiting for you to send.

list_activityList activity

The 50 most recent events in a knyte, and whether an assistant did them.

Tools that add

create_projectCreate project

Starts a new knyte owned by you, with a name and kind. Up to five an hour.

create_noteCreate note

Adds a note, open question, summary or lecture note, optionally linked to a marked passage.

create_taskCreate task

Adds a task. It cannot edit or complete existing tasks.

raise_questionRaise question

Asks an open question among the group’s questions and decisions. Only people answer it, which records the decision.

propose_findingPropose finding

Proposes a claim backed by a source in the knyte. It stays a proposal until a person verifies it.

propose_source_metadataPropose reference details

Proposes a source’s reference details. Nothing changes until a person uses or declines them; a newer proposal replaces one still waiting.

propose_requestPropose request

Drafts a request from you to another member to review, answer or decide something. Nothing is sent until you send it in Knyte; a newer draft replaces your earlier one.

Limits

• get_material_text returns up to 60,000 characters and 40 pages per call. Pass next_cursor to continue where it stopped.
• search_material_text returns up to 25 passages per call; list_materials and list_notes up to 50.
• A linked Google Doc or Word document is checked for changes at most once a minute.
• A request to the server can be at most 64 KB.

Your data

Knyte receives only what a tool call sends: the tool’s name and its arguments, such as a knyte’s ID or a search query. Your conversation with the assistant is not sent to Knyte, and Knyte doesn’t read your assistant’s memory or chat history.

The assistant has your access and no more: Knyte’s database checks every call against your membership, so the assistant can’t reach knyten you are not in. Reads change nothing in the knyte. What the assistant adds is saved in the knyte like any other contribution, marked as an assistant’s and attributed to you, and shown in the knyte’s activity.

What an assistant reads is the group’s content. Knyte tells assistants to treat it as data, never as instructions, and keeps apart what the group confirmed, what assistants contributed and what no one has confirmed yet.

What happens to content once it is inside your assistant is governed by its provider’s terms, such as Anthropic’s for Claude. Knyte doesn’t sell your data or use it to train AI models.

Read the privacy policy

Disconnect

In Knyte, open Assistants and choose Disconnect next to the assistant. It can’t renew its access after that, and an access token it already holds expires within an hour.

Removing the connector in your assistant’s settings stops the assistant using it. Disconnect it in Knyte as well to end the authorization.

Troubleshooting

Claude doesn’t use Knyte in a chat

Check that Knyte is turned on for the chat under the + button. Naming it helps, for example “In Knyte, what did we decide about…”.

The assistant can’t find a knyte

It sees only knyten you are a member of. Ask which account it is connected as; if it is the wrong one, disconnect it and connect again with the right account. If you are not a member yet, ask someone in the group to invite you.

Knyte says the assistant is not recognised

Knyte names Claude and ChatGPT when the sign-in returns to claude.ai, claude.com or chatgpt.com. Other clients, such as Claude Code or the MCP Inspector, return elsewhere and get a warning. Allow access only if you started the connection yourself.

The sign-in says the request is missing or has expired

Start connecting again from your assistant, and finish signing in in the window it opens.

A material has no text

A saved link has no text to read, and neither does a scanned PDF without a text layer: run it through OCR and upload it again.

Creating a knyte fails

On the free plan you have one knyte of your own, and an assistant can create at most five knyten an hour. The assistant passes Knyte’s message on.

It worked before and now it doesn’t

If the assistant was disconnected in Knyte, connect it again: remove Knyte in your assistant’s settings and add it once more.

My assistant can’t connect to MCP servers

Use Copy for your assistant in any knyte. It gives you the knyte’s context as text to paste into any chat.

Support

Email hello@knyte.app with what you asked, which assistant you use and what happened. We answer in English or Swedish. Report security issues to the same address.

Knyte is run by Clyqra in Sweden.