Quickstart: your agent
Connect an agent to your team's files, ask one question, and check the citation.
Before you start
- A ByteRover team. If you don't have one, create a team. If you're in several teams, you choose one when you connect.
- At least one file in a drive with the status Searchable. See Upload files.
- An agent that speaks MCP, such as Claude, ChatGPT, Cursor or Grok.
Connect and ask
Copy the address
In ByteRover, select Connect your AI tools in the sidebar, then Copy URL.
Give the address to your agent
Ask your agent to set up ByteRover's MCP server with this URL. The agent then starts the sign-in. Client notes has the steps for some agents.
Allow the connection
Your browser opens a ByteRover page asking whether the agent may use your team. Under It will be able to, it lists the permissions the agent asked for, which can be one or both of these:
- Search and read documents, in the drives that you can use.
- Add and update documents, where you are an editor or an admin.
Select Allow, and the page changes to You're connected.
Ask a question in a new conversation
Start a new conversation so the agent loads the ByteRover tools. Then ask a question that depends on your organization's documents. You don't need to name ByteRover:
Which policy section covers EU refunds?Check that it worked
The agent calls the search tool and answers from the passages it gets back. A good answer names the page and heading of each passage:
EU customers can cancel within 14 days of delivery and get a full refund.
Source: page 6, Refunds > European Union.Open the file in ByteRover and go to that page to find the passage.
Ask a question that has no answer
Ask about something your files don't cover:
Is there a policy on drone inspections?A search returns the passages nearest to your question. When none of them answers it, the agent has to tell you that your files don't answer the question. That's the correct result, and it shows you which file to add. If your agent answers from memory instead, tell it to answer only from ByteRover.
If it fails
For other problems, see Troubleshooting.
Next
- MCP tools: what the agent can call, and what each call returns.
- Permissions and sessions: the agent acts on your behalf and reaches only what you can reach.
- Search effort: when to ask the agent for
high.