Overview
Cosense MCP Server is a server designed for the Cosense platform, enabling interaction with Cosense pages through various tools.
To use the Cosense MCP Server, configure your MCP client with the required environment variables and run the server using npm or from source.
- Retrieve pages with specified titles using
get_page. - List available pages in the resources withlist_pages. - Search for pages containing specific query strings usingsearch_pages. - Insert text into pages withinsert_lines.
- Managing and retrieving content from Cosense pages.
- Automating interactions with the Cosense platform.
- Debugging and inspecting MCP server communications.
Add to your AI client
Use these steps to connect Cosense MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"cosense-mcp-server-yosider": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cosense-mcp-server-yosider"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"cosense-mcp-server-yosider": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cosense-mcp-server-yosider"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"cosense-mcp-server-yosider": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cosense-mcp-server-yosider"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"cosense-mcp-server-yosider": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cosense-mcp-server-yosider"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cosense-mcp-server-yosider": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cosense-mcp-server-yosider"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"cosense-mcp-server-yosider": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cosense-mcp-server-yosider"
]
}
}
}FAQ
What environment variables are required?
You need to set `COSENSE_PROJECT_NAME` and `COSENSE_SID` for authentication and project identification.
Can I run the server from source?
Yes! You can clone the repository, build it, and run it from your local environment.
How can I debug the MCP server?
Use the MCP Inspector for debugging, which provides tools accessible via a URL in your browser.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":872,"uuid":"f808b010-84f4-4e2a-a984-a91d65eb38c4","name":"cosense-mcp-server","title":"Cosense MCP Server","description":"A MCP Server for Cosense","avatar_url":"https://avatars.githubusercontent.com/u/22992974?v=4","created_at":"2025-01-28T02:15:49.139Z","updated_at":"2025-02-23T07:13:16.242Z","status":"created","author_name":"yosider","author_avatar_url":"https://avatars.githubusercontent.com/u/22992974?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/yosider/cosense-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"3\",\"license\":\"\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-12 08:26:36\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]