Frequently asked questions
Q: How do I use Sokket?
Section titled “Q: How do I use Sokket?”A: Contributors create and publish libraries in the web app. Once published, anyone in your organisation can access them through connected tools like Cursor, Claude, or Gemini. It all works through the Model Context Protocol (MCP). See the get started guide to get started.
Q: What are /instructions and @knowledge?
Section titled “Q: What are /instructions and @knowledge?”A: @knowledge files are static reference material like API specs, schemas, or guides. /instructions are prompt templates that reference @knowledge and accept $arguments. Together, they form libraries. See /instructions and @knowledge for details.
Q: How do $arguments and @references work in /instructions?
Section titled “Q: How do $arguments and @references work in /instructions?”A: $arguments let users provide input to /instructions. Type $variableName in a /instruction to create a $argument. Each $argument needs a description and you set whether it’s required or optional. @references pull in @knowledge files. Type @knowledgeFileName to reference a @knowledge file. @reference descriptions are optional but help explain why that @knowledge is included. See creating /instructions for more.
Q: How do I add existing content (like a JSON schema or README) to Sokket?
Section titled “Q: How do I add existing content (like a JSON schema or README) to Sokket?”A: Create a new @knowledge file in a library, then copy and paste content into the editor. Sokket uses markdown files (.md), so you can include JSON, code blocks, or any text content. See creating @knowledge files for details.
Q: What’s the difference between Draft and Published?
Section titled “Q: What’s the difference between Draft and Published?”A: Draft files are private and only visible to Contributors in the web app. They’re not available to team tools. Published files are the live version teams can access through connected tools. When you create or edit a file, it starts as a Draft. Select Publish when you’re ready to make it available. See the publishing workflow for more.
Q: What happens when I edit a Published file?
Section titled “Q: What happens when I edit a Published file?”A: When you edit a Published file, Sokket automatically creates a private Draft. The team continues to use the stable Published version until you select Publish on the new changes. See the publishing workflow for more.
Q: I see a library called “Sample Library” in my workspace. What is it?
Section titled “Q: I see a library called “Sample Library” in my workspace. What is it?”A: The Sample Library is a regular library pre-installed in every new organisation. It contains example /instructions and @knowledge to help test the first tool connection. You can edit, publish, or delete it like any other library. See /instructions and @knowledge to understand how to create libraries.
Q: How do I connect my tool?
Section titled “Q: How do I connect my tool?”A: Select the Connect button in the dashboard, copy the hosted MCP endpoint URL, and paste it into the tool’s MCP settings (Cursor, Claude, or Gemini). You’ll be prompted to authorise Sokket in the browser. See the connect tools guide for step-by-step instructions.
Q: What tools are supported?
Section titled “Q: What tools are supported?”A: Sokket works with any tool that supports the Model Context Protocol. Specific setup instructions are provided for Cursor, Claude Desktop, and Gemini. Other MCP-compatible tools can connect using the organisation’s hosted MCP endpoint URL.
Q: Does Sokket support version history or Git-sync?
Section titled “Q: Does Sokket support version history or Git-sync?”A: Sokket does not currently support version history or Git-sync. The Draft and Published workflow provides safe editing by keeping changes private until you publish.
Q: Can I have multiple libraries in my organisation?
Section titled “Q: Can I have multiple libraries in my organisation?”A: Yes. Each organisation can have multiple libraries. Create separate libraries for different projects, teams, or contexts. Each library is published independently.
Q: What happens if I delete a library?
Section titled “Q: What happens if I delete a library?”A: Deleting a library removes it from the organisation. Published content becomes unavailable to connected tools immediately. This action cannot be undone, so make sure the team no longer needs it.
Q: Can I rename a library or file?
Section titled “Q: Can I rename a library or file?”A: Yes. You can rename libraries and files from the dashboard. If you rename a @knowledge file, make sure any /instructions that reference it use the new name.
Q: What happens if I reference a @knowledge file that doesn’t exist in a /instruction?
Section titled “Q: What happens if I reference a @knowledge file that doesn’t exist in a /instruction?”A: You cannot publish a /instruction with broken @references. Sokket validates that all @references match existing @knowledge files before publishing. Fix or remove broken @references to publish.
Q: Can I use the same MCP endpoint URL for multiple tools?
Section titled “Q: Can I use the same MCP endpoint URL for multiple tools?”A: Yes. The organisation’s hosted MCP endpoint URL works with all MCP-compatible tools. You can connect Cursor, Claude, Gemini, and other tools to the same endpoint to access libraries.
Q: How do I know if my connection is working?
Section titled “Q: How do I know if my connection is working?”A: After connecting, check the tool’s context menu (e.g., type @ in Cursor). You should see commands from the Sample Library. If you don’t see them, check the MCP configuration and authorisation.
Q: What file formats are supported for @knowledge files?
Section titled “Q: What file formats are supported for @knowledge files?”A: @knowledge files use Markdown (.md). You can include JSON, code blocks, diagrams, and other text content within Markdown. Paste content directly into the editor.
Q: What happens if I unpublish a library?
Section titled “Q: What happens if I unpublish a library?”A: Unpublishing makes the library unavailable to connected tools. Team members can no longer access it. You can republish it later. Draft versions remain in the Sokket web app.
Q: Can I use Sokket with tools other than Cursor, Claude, or Gemini?
Section titled “Q: Can I use Sokket with tools other than Cursor, Claude, or Gemini?”A: Yes. Sokket works with any tool that supports the Model Context Protocol. Use the organisation’s hosted MCP endpoint URL in the tool’s MCP settings. Some tools may require specific configuration formats.
Q: What happens if I delete a @knowledge file that’s referenced by a /instruction?
Section titled “Q: What happens if I delete a @knowledge file that’s referenced by a /instruction?”A: You cannot delete a @knowledge file that’s referenced by a Published /instruction. Unpublish or remove the @reference first, then delete the @knowledge file. This prevents broken @references.
Q: What’s the difference between a “contributor” and a “consumer” seat?
Section titled “Q: What’s the difference between a “contributor” and a “consumer” seat?”A: Contributors are paid seats for users who need to create, edit, and manage team libraries. Consumers are free, read-only seats. They can connect to and use libraries in their tools but can’t edit them. The Team plan includes unlimited consumer seats. See sharing context and seat types for more.
Q: How do I invite team members?
Section titled “Q: How do I invite team members?”A: Navigate to Settings > Team, select the Invite button, enter the email address, select their role (Contributor or Consumer), and select Send Invite. They’ll receive an email to join the organisation. See the team management guide for detailed steps.
Q: Can my organisation have more than one Owner?
Section titled “Q: Can my organisation have more than one Owner?”A: Yes. An organisation can have multiple Owners. Owners have full read/write access and can manage billing, seats, and team settings. See the billing guide for more.
Q: What’s the difference between an Owner and a Contributor?
Section titled “Q: What’s the difference between an Owner and a Contributor?”A: Owners can manage billing, seats, and team settings in addition to creating and editing content. Contributors can create, edit, and publish libraries but cannot manage billing. Both use paid seats.
Q: How do I remove a team member?
Section titled “Q: How do I remove a team member?”A: Owners can remove team members from team settings. Removing a Contributor frees their seat. Removing a Consumer has no billing impact. The removed member loses access immediately.
Q: Can I transfer ownership of my organisation?
Section titled “Q: Can I transfer ownership of my organisation?”A: Ownership transfer is not currently supported. Contact support if you need to transfer ownership.
Q: Can Consumers see Draft files?
Section titled “Q: Can Consumers see Draft files?”A: No. Draft files are only visible to Contributors and Owners in the Sokket web app. Consumers can only access published libraries through their connected tools.
Q: How many Contributors can I have on the free trial?
Section titled “Q: How many Contributors can I have on the free trial?”A: The 14-day free trial is limited to one Contributor seat (assigned to you, the Owner). You can invite unlimited Consumers during the trial. See billing and subscriptions for more.
Q: What happens when my trial ends?
Section titled “Q: What happens when my trial ends?”A: A reminder email will be sent before the trial expires. You’ll then be prompted to add a payment method to continue on the Team plan. If you choose not to upgrade, all users in the organisation (including you) will have their roles changed to Consumers. You can still access and use published libraries, but you won’t be able to create or edit content until you upgrade. You will never be charged without explicit permission. See the billing guide for details on upgrading.
Q: Can I change my plan or cancel at any time?
Section titled “Q: Can I change my plan or cancel at any time?”A: Yes. You can add or remove contributor seats at any time from the billing dashboard. You can also cancel your subscription at any time. If you cancel, you’ll retain full access for the remainder of the paid billing period. See how to manage your subscription.
Q: Is my data private?
Section titled “Q: Is my data private?”A: Yes. Organisation data is private to the organisation. Each organisation’s data is completely separate and isolated.
Q: What happens to my data if I cancel my subscription?
Section titled “Q: What happens to my data if I cancel my subscription?”A: If you cancel your subscription, data remains stored and accessible. All users become Consumers, so they can still access and use published libraries but cannot create or edit content. You can restore Contributor access by reactivating your subscription.
Q: Can I export my libraries?
Section titled “Q: Can I export my libraries?”A: Not right now. Content stays accessible in the Sokket web app. Contact support if you need to export data.
Q: Is there a limit to the size of @knowledge or /instruction files?
Section titled “Q: Is there a limit to the size of @knowledge or /instruction files?”A: Large content is supported via Cloudflare R2. Very large files may affect performance. Keep files focused and split very large content into multiple @knowledge files if needed.
Q: My new /instruction isn’t appearing in my connected tool
Section titled “Q: My new /instruction isn’t appearing in my connected tool”A: Make sure the /instruction is Published, not Draft. Only Published content is available to MCP-compatible tools. Also check that the /instruction has a Description and all $arguments have descriptions and required/optional settings.
Q: My new @knowledge file isn’t appearing in my connected tool
Section titled “Q: My new @knowledge file isn’t appearing in my connected tool”A: The @knowledge file is likely still a Draft. Only Published items are sent to the MCP endpoint. Drafts are visible only in the Sokket web app. Make sure you’ve selected Publish on the @knowledge file.
Q: The Publish button is disabled for my /instruction
Section titled “Q: The Publish button is disabled for my /instruction”A: Check the Properties panel. All /instructions must have a Description, all $arguments must have their own Description and Required? toggle set, and all @references must resolve to existing, published @knowledge files. Fix any missing mandatory fields to enable publishing.
Q: The Publish button is disabled for my @knowledge file
Section titled “Q: The Publish button is disabled for my @knowledge file”A: All @knowledge files must have a Description. Check the Properties panel and fill in the missing Description field.
Q: My /instruction runs, but the tool doesn’t ask for an argument
Section titled “Q: My /instruction runs, but the tool doesn’t ask for an argument”A: The Required? toggle for that $argument is likely set to Optional. Set it to Required in the Properties panel to mark it as mandatory, then republish the /instruction.
Q: A /instruction reference to a @knowledge file fails
Section titled “Q: A /instruction reference to a @knowledge file fails”A: The referenced @knowledge file is not published, or the reference name doesn’t match the filename exactly. Check spelling and casing. Publish the @knowledge file or fix the reference name in the /instruction, then republish the /instruction.
Q: What happens if I reference a @knowledge file that doesn’t exist in a /instruction?
Section titled “Q: What happens if I reference a @knowledge file that doesn’t exist in a /instruction?”A: You cannot publish a /instruction with broken @references. Sokket validates that all @references match existing @knowledge files before publishing. Fix or remove broken @references to publish.
Q: What happens if I delete a @knowledge file that’s referenced by a /instruction?
Section titled “Q: What happens if I delete a @knowledge file that’s referenced by a /instruction?”A: You can’t delete a @knowledge file that’s referenced by a Published /instruction. Unpublish or remove the @reference first, then delete the @knowledge file. This prevents broken @references.
Q: How do I know if my connection is working?
Section titled “Q: How do I know if my connection is working?”A: After connecting, check the tool’s context menu (e.g., type @ in Cursor). You should see commands from the Sample Library. If you don’t see them, check the MCP configuration and authorisation.
Q: What happens if I rename a @knowledge file that’s referenced by a /instruction?
Section titled “Q: What happens if I rename a @knowledge file that’s referenced by a /instruction?”A: If you rename a @knowledge file, make sure any /instructions that reference it use the new name. Update the @reference in the /instruction to match the new filename exactly, then republish the /instruction.
Q: I can’t select a Contributor seat when inviting a team member
Section titled “Q: I can’t select a Contributor seat when inviting a team member”A: The organisation has no available paid seats. Only Owners can add seats through billing management on the Team management page. You can only invite a Contributor if there’s an available, “unassigned” paid seat. You can invite unlimited Consumers for free.
Q: How do I get support?
Section titled “Q: How do I get support?”A: Contact support at contact@sokket.ai.