Skip to content

Commit 377fb7f

Browse files
committed
Save
1 parent 407816f commit 377fb7f

2 files changed

Lines changed: 8 additions & 39 deletions

File tree

bun.lock

Lines changed: 1 addition & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

content/docs/guide/devfolio-mcp.mdx

Lines changed: 7 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,9 @@ title: Devfolio MCP
44

55
import { Tabs, Tab } from "fumadocs-ui/components/tabs";
66

7-
Devfolio MCP lets you connect Devfolio to AI tools like [Claude Code](https://code.claude.com/docs/en/overview), [Codex](https://openai.com/codex), and [Cursor](https://www.cursor.com/) so they can help with hackathon submissions using your Devfolio context.
7+
Devfolio [MCP](https://nsb.dev/devfolio-mcp-explainer) lets you connect Devfolio to AI tools like [Claude Code](https://code.claude.com/docs/en/overview), [Codex](https://openai.com/codex), and [Cursor](https://www.cursor.com/), so they can help you with your hackathon submissions using context from your local project files.
88

9-
**MCP** stands for **[Model Context Protocol](https://nsb.dev/devfolio-mcp-explainer)**. It lets compatible AI tools securely connect to external apps and use relevant context while helping you.
10-
11-
Once connected, your AI tool can use your Devfolio context to help draft and improve your hackathon submission.
9+
Once connected, your AI tool can quickly understand your codebase, help you write stronger submissions faster, surface relevant tracks to apply for, and make it easier to showcase what you’ve built.
1210

1311
<iframe
1412
width="100%"
@@ -26,24 +24,21 @@ Once connected, your AI tool can use your Devfolio context to help draft and imp
2624
2. Click `Generate API key`.
2725
3. Choose the setup format for your AI tool.
2826
4. Paste the prompt, run the command, or copy the JSON shown.
29-
5. Ask your assistant to help with your hackathon project submission.
3027

3128
<Callout title="Keep your API key private" type="error">
3229
Your MCP API key is sensitive, like a password. Anyone with access can act on your behalf. If it is compromised, revoke it and generate a new one right away.
3330
</Callout>
3431

3532
## Where Can I Find Devfolio MCP?
3633

37-
You can access Devfolio MCP from Account Settings. You may also see MCP shortcuts during the hackathon project submission flow.
34+
You can find Devfolio MCP in Account Settings, your hackathon dashboard, and the project submission page.
3835

39-
You will see these shortcuts only for hackathons where project submissions are open and your account is eligible to submit.
36+
Hackathon dashboard and submission-page shortcuts appear only when project submissions are open and your account is eligible to submit.
4037

4138
### 1. From Account Settings
4239

4340
Go to your profile menu, open `Account Settings`, and select the `MCP` tab.
4441

45-
This is the main place to create and manage your MCP API key.
46-
4742
<img src="/assets/mcp-setting.webp" alt="Devfolio MCP tab in Account Settings" />
4843

4944
Click `Generate API key` to create your MCP API key.
@@ -54,42 +49,24 @@ Click `Generate API key` to create your MCP API key.
5449

5550
For hackathons where submissions are open to you, you may also see an `MCP Integration` card on your hackathon dashboard.
5651

57-
This card lets you:
58-
59-
- Check whether MCP is ready.
60-
- Set up MCP if you have not connected it yet.
61-
- View your MCP setup if it is already connected.
62-
- Revoke MCP access if needed.
63-
- Open a quick explainer for how MCP works.
64-
6552
<img src="/assets/mcp-dashboard.webp" alt="MCP Integration card on a hackathon dashboard" />
6653

6754
<img src="/assets/mcp-configure-model-dashboard.webp" alt="Devfolio MCP setup window opened from the hackathon dashboard" />
6855

6956
### 3. From the Project Submission Page
7057

71-
When you are submitting a hackathon project, you may see a small floating MCP assistant button in the bottom-right corner of the submission page.
72-
73-
Before setup, hovering over the button shows:
74-
75-
`Save Time. Submit via MCP.`
76-
77-
After MCP is connected, it says:
78-
79-
`MCP enabled`
58+
When you are submitting a hackathon project, you may see a small floating MCP assistant button in the bottom-left corner of the submission page.
8059

8160
<img src="/assets/mcp-project.webp" alt="MCP assistant button on the project submission page" />
8261

83-
Clicking this button opens the MCP setup window without leaving the submission page.
62+
Clicking this button opens the MCP setup window.
8463

8564
<img src="/assets/mcp-configure-model-project.webp" alt="Devfolio MCP setup window opened from the project submission page" />
8665

8766
## Setup Commands and Configuration
8867

8968
Devfolio fills in your actual MCP API key in the setup window. The examples below use `YOUR_API_KEY` as a placeholder.
9069

91-
Choose the tab that matches your AI tool.
92-
9370
<Tabs items={["Prompt", "Claude Code", "Codex", "Cursor", "JSON"]}>
9471
<Tab value="Prompt">
9572

@@ -147,7 +124,7 @@ If your MCP client asks for a JSON configuration, copy this setup from Devfolio
147124
</Tab>
148125
</Tabs>
149126

150-
## What Can I Ask My AI Assistant?
127+
## Example Prompts
151128

152129
After connecting Devfolio MCP, try prompts like:
153130

@@ -157,13 +134,6 @@ After connecting Devfolio MCP, try prompts like:
157134
- `Check whether my submission is missing anything important.`
158135
- `Summarize the prizes for this hackathon.`
159136

160-
## Troubleshooting
161-
162-
- If you do not see the `MCP Integration` card, check that project submissions are available for that hackathon and that you are eligible to submit.
163-
- If you are on a phone, use a desktop device for the dashboard and submission-page MCP setup shortcuts.
164-
- If your API key may be compromised, revoke access from [`Account Settings > MCP`](https://devfolio.co/settings/mcp) and generate a new key.
165-
- If your AI tool does not accept the setup details, use the `JSON` option with any MCP-compatible client that supports remote MCP servers.
166-
167137
<Callout title="Access control" type="info">
168138
You can manage or revoke MCP access from [`Account Settings > MCP`](https://devfolio.co/settings/mcp).
169139
</Callout>

0 commit comments

Comments
 (0)