Articles in this section

[Admin & Rep Guide] Create and update content with Spekit MCP

You can draft a Spek in your AI conversation and file it straight into Spekit, with no copy and paste. The connector can also create Topics, create content from your company's templates, and update Speks you already have.

ℹ️ Write tools run as you. If your Spekit role does not let you create or change content in the web app, it will not let you do it through an AI tool either.

 

1. Before you start

You need the Spekit connector set up in your AI tool, and a Spekit role that allows content creation.

Your AI tool's plan can also limit this. On ChatGPT, write tools are limited to Business, Enterprise, and Education. See Connect Spekit to ChatGPT.

ℹ️ Anything you create through the connector is live Spekit content, filed under your name. Review it before your team starts using it.

 

2. Draft against your style guide

Spekit has a content style guide that holds your design system rules for authoring. Ask your AI tool to pull it before it drafts, so the result matches the rest of your library instead of looking like generic AI output.

This is not a style suggestion. Content is checked against those rules when it is created. If it does not follow them, the create is rejected and your AI tool is told what to fix. Content that skips the rules renders as plain text instead of picking up your brand.

A good pattern is: pull the style guide, pull an existing Spek on a related subject, then draft the new one. The existing Spek shows the tone, the style guide shows the rules.

💡 Pro Tip: Drafting and creating are separate steps. Ask for the draft first, read it, then ask your AI tool to create it. That gives you a review point before anything lands in Spekit.

 

3. Create a Spek

Ask your AI tool to create the content, and tell it which Topic or Topics to file it under. A Spek can sit under more than one Topic.

If your company has content templates, your AI tool asks whether to start from one or from scratch before it creates anything. See section 4.

What to include in your request:

Include Why
The title Otherwise the AI tool picks one for you.
The Topic or Topics Required. Every Spek has to be filed under at least one existing Topic.
The body, or the draft to use Point at the draft already in your conversation.

⚠️ The Topic has to already exist. If none of the Topic names match, nothing is created. Ask your AI tool to list your Topics first, or create the Topic before the Spek.

 

4. Create a Spek from a template

If your company uses content templates, you can start from one instead of a blank draft.

  1. Ask your AI tool to list the content templates available to your company.
  2. Ask for the template you want. It returns the template body and its fill instructions.
  3. Ask your AI tool to create a new Spek from that template, with your details filled in.

Templates are the better route for recurring content types, since the structure is already agreed by your team.

 

5. Create a Topic

You can create a Topic on its own, or as a subtopic of a Topic you already have.

Say where it belongs in your request. A Topic created without a parent sits at the top level, which is rarely what you want for a narrow subject.

Whether you can create a top-level Topic depends on your role. If your role does not allow it, the request is rejected and your AI tool asks which existing Topic to nest the new one under. Account Admins can create Topics at the top level.

💡 Pro Tip: Check the existing Topic tree first. Ask your AI tool to list your Topics before you create a new one, so you do not end up with two Topics covering the same ground.

 

6. Update an existing Spek

The update tool changes a Spek you already have. You can change:

What you can update Note
The title The old title stops being searchable, so tell your team.
The body Replaces the current content.
Topic assignment Changes where the Spek is filed.

Pull the current Spek first so you can see what you are replacing. Updating is not a suggestion, it changes the live content.

 

7. Turn sharing on or off for content

Content has to be marked shareable in Spekit before it can go into a Deal Room or a Trackable Link. Your AI tool can change that for a Spek or a file.

ℹ️ Account Admins, Team Admins, and Experts can change the share setting on Team Hub content. Viewers cannot, and asking through an AI tool does not change that.

What you can do Note
Turn sharing on The content can then go into a Deal Room or a share link.
Turn sharing off Hides the content in every Deal Room and share link it is in, until it is turned on again. For files, this also turns off download.

One thing to know: content imported from Confluence, Notion, or SharePoint pages cannot be shared at all.

⚠️ Turning sharing off affects every Deal Room the content is already in, not just the one you are thinking about. Check before you withdraw something.

 

8. Build a set of content in one request

One request can run several steps in order. For example, a launch content set can read your approved messaging, then draft and create each piece in turn, from that one request.

This is useful when the pieces depend on each other, such as a positioning Spek that the objection handling Speks then reference.

The tradeoff is review. A single request that creates 6 Speks gives you 1 review point instead of 6. For a launch where the wording matters, ask for the full set as a draft first, then create.

 

9. Best practices

Practice Why it helps
Pull the style guide before drafting Keeps new content consistent with the rest of your library.
Draft, review, then create Gives you a checkpoint before anything goes live.
Always name the Topic Content with no Topic is hard for your team to find later.
Read the current Spek before updating it Updates replace content. There is no suggestion step.
Tell your team when you rename a Spek People search for the old title.
Check what else uses content before you unshare it Turning sharing off pulls it from every Deal Room it is in.
Was this article helpful?
0 out of 0 found this helpful